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APPENDIX  A.  TOOL  DESCRIPTIONS 

1.  Foncttonal  Dcflgn  Tools 

1.1  'PEG'; 

Translates  a  finite  state  machine  description  into  logic  equations. 

\2  'EQNTOTT: 

Converts  logic  equations  into  a  truth  table  format. 

13  'PRESTO*: 

Minimizes  truth  table  attributes. 

2.  Layoot  Tools 

2.1  'CFL': 

Library  of  coordinate  free  layout  procedures. 

2.2  'CAESAR': 

Graphical  layout  editor. 

23  TPLA': 

Technology  independent  pla  generator. 

2.4  'PADS': 

Padframe  generator. 

3.  Display  Tools 

3.1  'CIFPLOT': 

Plots  CIF  designs  using  stipple  patterns. 

3.2  'VIC': 

Displays  designs  on  TEK  4010  compatible  devices  and  drives  penplotters. 

4.  Rule  Checkers 

4.1  'CDRC': 

Checks  CIF  designs  against  CMOS  rules. 

4.2  'LYRA': 

Performs  hierarchical  design  rule  check. 

5.  Circuit  Extractor^ 

1  5.1'MEXTRA^ 

Extfacts  circuit  description  from  CIF  design. 

6.  Simulation  Tools 

6.1  'SP1CE2G6': 

Device  level  circuit  simulator. 

6.2  'RNL': 

Event  driven  timing  simulator. 

63  'MTP*; 

Displays  RNL  and  SPICE  output  on  a  line  printer. 

6.4  'SIMSCOPE': 

Displays  RNL  and  SPICE  output  on  a  CRT. 

7.  UtlUtles^Mlacellaacons  . 

7.1  'NETLIST: 

Generates  circuit  description  procedurally. 

12  'PRESIM*; 

Converts  a  circuit  derrription  to  RNL  input. 

73  'PSPICE': 

Creates  a  complete  q)ice  input  deck  from  a  circuit  description  and  user  input. 

7.4  'CELLIB': 

Layouts  of  a  set  of  standard  cells  and  pads  in  CMOS. 

• 

/  ^  - 

•  » 

>  .  V  •  ■ 

n  unclassified 

SECUMITV  CLAtWriCATION  O^ThU  PAOCr»hMi  0#««  »Mf4) 


vs 


V.*  • 

-•‘'is 


VLSI  Design  Tools 

Reference  Manual 


Release  3.0 


06/0^85 

TR#  85-07-03 


Accession  For 

NTIS  GRA&I 
DTIC  TAB 

Unamiounoed  Q 
Justification _ 


¥ 


By - - - - 

Distribution/ 

Availabiiit^Codes 

lAvaii  ^d7or 
Dist  I  Special 


UW/NW  VLSI  Consortium 

Department  of  Computer  Science 
Room  31S  Sieg  Hall 
University  of  Washington  FR-3S 
Seattle,  Washington  9819S 


_•  •• 

•  •-  *•  ••  \  •, 


■  *.  **•  **.  **/''"*%  •*v_**\.**»  ^*%^**#  •%  !»' 


TABLE  OF  CONTENTS 


1.  Introduction 

1.1  Who  We  Are  :  The  UW/NW  VLSI  Consortium 
12  Installation  Instructions 

2.  Overview  of  VLSI  Design  Tools 

2.1  Enhancements  since  Release  2.1 

22  Layout  Tools  :  Functional  Chart 

23  Simulation  Tools  :  Functional  Chart 

2.4  Tool  Descriptions 

3.  Manual  Pages 

4.  Coordinate  Free  LAP  Reference  Manual 

5.  Editing  VLSI  Circuits  with  Caesar 

6.  Standard  Cell  Library  Guide 

7.  NETLIST/PRESIM/RNL  Users  Guides  and  Tutorials 

6.1  NETLIST  User’s  Guide 

62  PRESIM  User’s  Guide 

63  RNL  User’s  Guide 

6.4  NETLIST  and  RNL  Tutorial  for  Beginners 
63  NETLIST/PRESIM/RNL  •  A  Tutorial 

8.  SPICE  User’s  Guide 

9.  Designing  Finite  State  Machines  with  PEG 

10.  Specifying  Design  Rules  for  Lyra 


INTRODUCTION 


Wh«  W«  An  :  Tha  UnlvNitty  of  WflaUagton/NartAwcat  VLSI  CooMiHom 

UW/NW  VLSI  Consortium  members  include  the  University  of  Washington,  represented  by 
the  Computer  Science  Department,  and  five  Pacific  Northwest  firms:  Boeing  Aerospace, 
Honeywell  Marine  Systems,  John  Fluke  Manufacturing,  Microtel  Pacific  Research  of  Canada, 
and  Tektronix,  Ine.  The  purpose  of  the  Consortium  is  to  advance  the  state  of  the  art  in  VLSI 
technology  and  to  transfer  this  technology  between  industry  and  the  university. 

Each  corporate  member  of  the  Consortium  has  a  full-time  liaison  on  campus  who  cooperates 
with  faculty  and  students  on  circuit  design  as  well  as  filling  the  role  of  visiting  faculty,  work¬ 
ing  with  graduate  students  and  contributing  valuaUe  'teal  world'  experience  to  the  Depart¬ 
ment  of  Computer  Science.  This  program  serves  as  a  demonstration  of  cooperative  research 
and  technology  exchange  among  universities  and  industries. 

The  Consortium  maintains  a  VLSI  design  system  and  plans  to  evolve  its  capability  over  time, 
as  well  as  to  provide  training  in  its  use.  The  Consortium  validates  the  system  by  exercisiag  it 
with  complex  design  problems.  Missing  pieces  are  identified  and  used  for  guiding  future 
research  and  development.  The  resulting  system  is  made  available  to  other  universities  and 
industry. 

The  research  activities  of  the  Consortium  are  focused  in  the  area  of  VLSI  design  generators  - 
programs  that  create  circuit  design  layouts  as  well  as  other  circuit  description  forms.  (Genera¬ 
tors  are  being  distributed  with  this  release;  others  may  be  exported  in  the  future.)  The  gen¬ 
erator  research  will  lead  to  a  general  methodology  for  building  generators  and  incorporating 
them  into  a  custom  VLSI  design  environment. 


UW/NW  VLSI  Release  3j0 


-2- 


ofi/oyss 


Introduction 


UW/NW  VLSI  Consortium 


InsUllaltoB  Proccdort 

The  distribution  tape  contains  VLSI  design  tools  that  run  on  a  VAX  with  Berkeley  42  UNIX. 
Many  of  them  will  not  run  on  other  machines  or  other  versions  of  UNIX.  In  addition,  VLSI 
display  tools  require  plotting  or  graphics  devices: 

Pen  plotters  (HP722:.  HP7SS0) 

Dot  matrix  printers  (Versatec,  Varian,  Printroniz) 

Interactive  graphics  devices  with  bitpads  (AEDS12,  Metheus  Omega  440) 

The  tape  contains  two  1600-bpi  tar  format  files: 

1)  UW/NW  VLSI  Design  Tools,  Release  2.1. 

2)  VLSI  Tools  for  42  Berkeley  UNIX  as  distributed  by  Berkeley  (1984  versions). 

The  first  file  includes  complete,  self-contained  tools  as  well  as  modifications  to  several  Berke¬ 
ley  tools  contained  in  the  second  file.  Organixation  of  the  first  file  is  as  follows: 

bin  executables  and  shell  scripts 

doc  user  manuals 

include  source  header  files  for  some  tools 

lib  archived  libraries  and  other  stuff 

man  UNIX  programmer’s  manual  entries  for  each  tool 

src  source  code,  make  files,  and  installation  scripts 

To  install  the  tools: 

1.  Copy  the  first  file  on  the  tape  to  a  suitable  directory  (on  our  system  it’s  /src/vlsi/vlsi- 
tools)  using  the  tar  command.  If  you  do  not  already  have  the  42  Berkeley  Tools  you 
will  need  to  copy  the  second  file  of  the  tape  into  some  other  directory. 

2.  Set  environment  variable  UW_VLSI_TOOLS  to  the  full  path  name  of  this  directory  (e.g. 
setenv  UW_VLSI_TOOLS  /sr^vlsi/vbi-tools).  (Put  this  in  your  login  file.) 

3.  Set  (login  file  again)  the  following  environment  variables: 

PATH  to  some  path  that  includes  $UW_VLSI_TOOLS/bin 
PLAPPATH  to  some  path  that  includes  $UW_VLSI_TOOLS/lib/technoIogy 
RNLPATH  to  some  path  that  includes  $UW_VLSI_TOOLS/Iib/mI 

Directory  $UW_VLSI_TOOLS/bin  should  precede  /usr/ucb  and  /usr/bin  if  you  want  to 
take  advantage  of  the  new  man  command  that  accesses  $UW_VLSI_TOOLS/man, 
*cad/man  (Berkeley  VLSI  tools),  and  /usr/man. 

4.  Cd  to  $UW_VLSI_TOOLS/src  and  run  ’MAKE  man’  to  initialize  the  manual  pages. 

5.  If  you  are  running  Berkeley  4.1  you  will  have  to  run  MAKEALL  (in 
$UW_VLSI_TOOLS/src)  to  recompile  everything.  Most  of  the  tools  have  been  run  suc¬ 
cessfully  on  4.1,  but  you  should  add  a  -Db^41  flag  in  src/lib/libutil/makefile  when  com¬ 
piling  on  4.1. 

There  are  several  improvements  (including  man  pages)  and  bug  fixes  for  the  42  Berkeley  tools 
available  in  $UW_VLSI_TOOLS/src/ucb-cad.42.  These  may  be  installed  using  the  INSTALL- 
UCB  script  in  $UW_VLSI_TOOLS/src.  You  may  wish  to  review  the  README  file  in 
SUW_VLSI_TOOLS/src/ucb-cad.42  and  edit  INSTALL-UCB  appropriately  if  you  want  only 
some  of  the  changes.  Since,  only  the  changed  source  files  are  included  in 
SUW_VLSI_TCX}LS/src/ucb-cad.42,  you  must  follow  the  procedures  documented  with  the 
Berkeley  VLSI  tools  to  complete  the  installation  after  using  INSTALL-UCB. 

The  following  miscellaneous  sources  are  included: 

Sources  for  Ipr  that  complement  the  changes  to  cifplot  and  allow  cifplot  to  be  used  with  a 
Printronix. 
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Sources  for  a  parallel  interface  device  driver  for  a  Metheus  omega  440  color  graphics  display. 
A  DEC  DR-llW  is  heeded  in  addition  to  the  Metheus. 
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2.0  OVERVIEW  OF  VLSI  DESIGN  TOOLS 
ENHANCEMENTS  SINCE  RELEASE  2.1 

A  major  improvement  in  the  design  system  has  been  the  addition  Coordinate  Free  LAP 
(CFL),  a  libruy  of  ”C*  procedures  that  facilitates  the  layout  of  VLSI  designs.  CFL  contains  a 
variety  of  operators  for  juxtaposing,  transforming  and  replicating  hierarchies  of  cells. 
Although  CFL  has  sufficient  functionality  to  allow  specification  of  arbitrary  rectlinear  mask 
geometries,  it  is  mainly  intended  to  be  used  in  the  chip  assembly  mode.  Hence  the  typical 
application  would  be  to  use  the  graphical  editor  Caesar  to  generate  lower  level  cells  (or  tiles) 
and  then  use  CFL  to  to  assemble  these  cells  into  higher  level  modules.  Routing  facilities  are 
provided  which  generate  a  variety  of  planar  and  nonplanar  wire  patterns  used  to  connect 
functional  blocks.  CFL  replaces  the  aging  Pascal-based  layout  facility  PLAP. 

A  number  of  layout  generators  have  been  written  with  the  CFL  facility.  Each  produces  a  Ia3^ 
out  consistent  with  the  MOSIS  3  micron  bulk  CMOS  q>ceification.  Ilie  multiplier  generator 
mult  produces  a  NxM  two’s  complement  multiplier  with  ripple  carry  addition.  The  generator 
decNor  produces  a  dynamic  nor  form  decoder  with  an  arbitrary  number  of  address  bits  and 
banks.  A  padframe  generator  padt  produces  a  MOSIS  -  acceptable  padframe  with  input,  out¬ 
put  and  tristate  pads  instantiated  according  to  user  specifications. 

Several  new  programs  have  been  added  to  allow  easier  construction  of  RNL  control  files. 
These  include  genjcoiurol  and  genjime.  A  new  display  program,  simseope,  will  display  signal 
behavior  derived  from  rnl  or  spic*  on  several  different  graphics  terminals. 

The  design  system  described  in  the  rest  of  this  manual  contains  a  number  of  tools  from  the 
1984  Berkeley  VLSI  Tools  Distribution.  Since  March  198S,  Berkeley  has  distributed  a  198S 
toolset  that  includes  magic,  mpack,  cifplot,  crystal,  esim,  and  various  PLA  tools.  For  informa¬ 
tion  on  these  tools  contact 

Prof.  John  K.  Ousterhout 
Computer  Science  Division 

Department  of  Electrical  Engineering  and  Computer  Sciences 
University  of  California 
Berkeley,  CA  94720 
(41S  642  0865) 
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TOOL  DESCRIPTIONS 

The  following  is  a  brief  overview  of  the  vlsi-tools  we  are  distributing.  An  asterisk  (*)  appears 

after  the  name  of  tools  that  are  contained  in  the  1984  Berkeley  Distribution. 

FascUonal  DcRgn  Tools 

peg  *  Translates  a  language  description  of  a  finite  state  machine  into  logic  equations 

compatible  with  eqnsott.  (  Gordon  Hamachi,  UCB  ) 

eqraott  *  Converts  logic  equations  into  a  truth  table  format  to  be  used  as  input  to  mkpla  or 
tpla.  (  Bob  Cmelik,  UCB  ) 

presto  Tries  to  minimize  the  number  of  product  terms  in  a  truth  table.  (  UCB  ) 

Layont  ConstnictloB  Tools 

caesar  *  A  display  editor  for  manhattan  designs  written  at  Berkeley.  Runs  on  AEDS12  or 
Metheus  Omega  440  color  displays.  Requires  a  design  to  be  inputted  in  caesar 
format  but  will  optionally  output  in  CIF.  (  John  Ousterhout,  UCB  ) 

c/1  A  library  of  C  procedures  for  assembling  caesar  formatted  cells  into  modules. 

Employed  by  pads,  decSor  and  mult.  (  William  Beckett,  UW/NW  VLSI  Consor¬ 
tium  ) 

pads  A  generator  for  constructing  a  MOSIS  padframe  with  user-specified  pad  types.  ( 

Wayne  Winder,  UW/NW  VLSI  Consortium  ) 

mult  A  generator  for  constructing  an  NxM  multiplier  in  MOSIS  CMOS.  (Wayne 

Winder,  UW/NW  VLSI  Consortium  ) 

decNor  A  generator  for  constructing  a  MOSIS  CMOS  'nor*  form  decoder  with  an  arbi¬ 
trary  number  of  inputs  and  banks.  (  David  Morgan,  UW/NW  VLSI  Consortium  ) 

tpla  *  Technology  independent  pla  artwork  generator.  Employs  a  Caesar-generated 
template  and  a  truth  table.  (  Robert  Mayo,  UCB  ) 

Layout  Dlqilay  Tools 

cifplot  *  Berkeley  program  that  plots  a  CIF  design  in  stipple  patterns  on  Versatec  or  Prin- 
tronix  dot-matrix  printers.  (  Dan  Fitzpatrick,  UCB  ) 

vie  Display  program  for  a  Tektronix  4010  compatible  device  with  penplot  options  for 

HP  4-  and  8-pen  plotters.  Takes  Caesar  files.  (  Bruce  Yanagida,  Boeing;  Larry 
McMurchie,  UW/NW  VLSI  Consortium  ) 

DesIgB  Rule  Checkers 

dre  Design  rule  checker  from  Camegie-Mellon.  Checks  MOSIS  NMOS  (buried  con¬ 

tact)  rules  on  Manhattan  CIF  desgns.  (  Dorothea  Haken,  CMU  ) 

drcscript  Merges  the  design  rule  violation  files  created  by  dre  with  the  CIF  design  file  for 
display  purposes.  (  Dorothea  Haken,  CMU  ) 

edre  Camegie-Mellon  design  rule  checker  with  MOSIS  CMOS  rules.  (Jagannathan 

Ramanujam) 

cdrcscript  Merges  edre  violation  files  with  the  CIF  file. 

lyra  *  Performs  hierarchical  design  rule  check  on  a  Caesar-formatted  design  using  a 
comer  based  algorithm.  NMOS  and  CMOS  rulesets  are  available.  (  Michael 
Arnold,  UCB  ) 

Circuit  Extractors 
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mextra  * 


spiee2g6 


ritl 

mtp 

simscope 


eif2ea  • 

netlisi 

preaim 

papiee 


alm2apiee  * 


apepp 


apice 

genjime 

genjeoiurol 

pld2net 


Extracts  a  iXim  file  from  a  CIF  input  file  for  use  in  preaim  and  aim2apice.  (  Dan 
Fitzpatrick,  UCB  ) 


Slmolatlea  Tools 

The  well  known  device  level  circait  simulator  with  minor  mods  to  output  an 
additional  file  that  allows  multiple  time  series  plots  to  be  made.  (  Lawrence 
Nagel,  UCB  ) 

An  event  driven  'timing*  simulator.  It  uses  logic  levels  and  a  simplified  circuit 
model  to  estimate  timing  delays  through  digital  circuits.  (  Chris  Terman,  MIT  ) 

Produces  signal  behavior  plots  on  a  Printroniz  printer,  the  simulation  output 
from  either  apiee  or  rid.  (William  Beckett,  UW/NW  VLSI  Consortium) 

Diqilajrs  signal  behavior  plots  on  a  Tek  4010  or  Tek  4105.  Input  can  come  from 
either  apice  or  rtd.  (  Rudolf  Nottrott  ) 

FUtccs  Md  Utmtlas 

Converts  from  CIF  format  to  caeaar  format.  (  Peter  Kessler,  UCB  ) 

Generates  circuit  descriptions  in  the  form  of  a  jlm  file.  (  Chris  Terman,  MIT  ) 

Converts  a  file  into  the  binary  format  required  by  rid.  In  the  process  preaim 
simplifies  the  circuit  by  identifying  gates  in  the  circuit.  (  Chris  Terman,  MTT  ) 

Runs  aiirdapiee  and  apepp.  In  addition  to  running  those  programs  it  concatenates 
various  files  so  as  to  create  a  complete  Spice  input  deck.  (  Rob  Fowler,  UW/NW 
VLSI  Consortium  ) 

Reads  a  Jim  file  containing  a  description  of  a  circuit  and  writes  a  jamas  file  and 
a  jplce  file.  The  James  file  contains  a  translation  from  node  names  in  the  jIm 
file  to  the  Spice  node  numbers.  The  jpics  file  contains  a  description  of  the  dev* 
ices  in  the  circuit  in  a  form  acceptible  to  Spice.  (  Dan  Fitzpatrick,  UCB  ) 

Facilitates  the  writing  of  Spice  input  by  allowing  the  user  to  refer  circuit  nodes 
using  mnemonic  node  labels  rather  than  Spice  node  numbers.  (  Rob  Fowler, 
UW/NW  VLSI  Consortium  ) 

A  cak  script  for  running  apiee2g6.  (  Lawrence  Nagel,  UCB  ) 

A  program  for  specifying  input  signal  patterns  to  rid.  (  Riekus  Koeman,  Fluke 
Manufacturing  ) 

Constructs  ml  control  files.  (  Riekus  Koeman,  Fluke  Manufacturing  ) 

Creates  a  PLA  description  for  use  in  netliai.  Input  is  a  truth  table  in  the  format 
of  preato  and  eqiuott.  (  Riekus  Koeman,  Fluke  Manufacturing  ) 
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A  VLSI  DESIGN  STRATEGY 

This  document  describes  a  strategy  for  creating  VLSI  designs  with  the  tools  of  this 
release.  Although  this  strategy  is  a  sequence  of  operations,  the  designer  should  realize  that 
iterating  between  them  may  yield  higher  performance  designs.  It  begins  by  partitioning  the 
project  into  modules  of  manageable  size,  then  for  each  module: 

1)  Define  and  partition  the  design  with  a  hi^  level  description. 

Block  diagram,  schematics  or  text  files. 

2)  Model  the  design  as  a  network  of  transistors. 

2a)  Create  the  network  of  transistors. 

2b)  Create  stimuli  for  this  network  and  simulate. 

2c)  Repeat  steps  2a  and  2b  until  the  design  is  stable. 

3)  Implement  the  design  as  a  collection  of  integrated  circuit  layers. 

3a)  Create  this  layout. 

3b)  Verify  that  the  layout  complies  with  the  design  rules. 

3c)  Extract  a  transistor  network  model  from  the  layout. 

3d)  Create  stimuli  (modified  from  2b)  and  simulate. 

3e)  Repeat  steps  3a3b,3c,3d  untO  the  desipi  is  stable. 

4)  Fabricate  the  design. 

5)  Test  the  design. 

Sa)  Exercise  the  integrated  circuit  with  simulation  stimuli. 

Sb)  Document  yield,  performance  and  simulation  discrepancies. 

Step  1  is  an  abstract  description  of  the  design's  operation.  Design  problems  can  be  rectified  at 
this  point  far  cheaper  than  at  any  other.  A  clear  and  concise  description  enhances  the  chance 
of  finding  design  problems  and  eliminating  interface  problems  with  other  designs.  Investing 
time  in  this  step  is  consistent  with  the  'topdown*  design  style  common  in  software  develop* 
ment. 

Step  2  can  identify  errors  which  would  take  many  hours  to  fix  if  discovered  in  a  completed 
layout.  Some  designers  eliminate  this  step  believing  that  design  time  will  be  reduced,  but  the 
validity  of  this  assumption  is  dependent  on  the  daign’s  complexity  and  the  designer’s  experi* 
ence.  The  novice  should  approach  this  shortcut  with  great  caution.  Commercial  designers 
avoid  this  tradeoff  with  schematic  capture  programs  that  translate  the  high  level  description 
directly  into  the  transistor  network  m^el. 
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The  following  outline  describes  the  tppropriate  tool  for  each  step  in  the  design  cycle: 


1)  High  Level  Description 

2)  Transistor  Network  Model 

Create  Network 

Transistor  Modeled  as  Switch 
By  Hand: 

Generate  PLAs: 


3)  Integrated  Circuit  Layout 
Create  Layout 
By  Hand: 

Generate  PLAs: 

Generate  Pad  Frames: 
Generate  Multipliers: 
Hardcopy: 

Verify  Design  Rules: 

Extract  Transistor  Model 

Transistor  Modeled  as  Switch: 
Detailed  Transistor  Model: 
Define  Stimulus  and  Simulate 

Transistor  Modeled  as  Switch: 
Detailed  Transistor  Model: 


NETLIST,  PRESIM 

PEG^QNTOTT,  PRESTO. 
n.A2NET.  PRESIM 

NETLIST,  PSPICE 

RNL.  SIMSCOPE.  MTP 
PSPICE.  SPICE.  SIMSCOPE,  MTP 


CAESAR.  CFL 

PEG,  EQNTOTT,  PRESTO,  TPLA 

PADS 

MULT 

CIFPLOT,  VIC,  PENPLOT 
LYRA, CDRC 

CAESAR.  MEXTRA,  PRESIM 
CAESAR.  MEXTRA,  PSPICE 

RNL,  SIMSCOPE,  MTP 
PSPICE,  SPICE,  SIMSCOPE.  MTP 


Detailed  Transistor  Model: 

Define  Stimulus  and  Simulate 

Transistor  Modeled  as  Switch: 
Detailed  Transistor  Model: 
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NAME 

caesar  -  VLSI  circuit  editor 
SYNOPSIS 

cacnr  [  -a  -g  graphics_port  -t  tablet_port  -p  path  -m  monitor_type  -d  display_type  ]  [  file  ] 
DESCRIPTION 

Caesar  is  an  interactive  system  for  editing  VLSI  circuits  at  the  level  of  mask  geometries.  It 
uses  a  variety  of  color  displays  with  a  bit  pad  as  well  as  a  standard  text  terminal.  For  a  com¬ 
plete  description  and  tutorial  introduction,  see  the  user  manual  'Editing  VLSI  Circuits  with 
Caesar*  (an  on-line  copy  is  in  'cad/doc/caesaribims). 

Command  line  switches  are: 

-n  Execute  in  non-interactive  mode. 

-g  The  next  argument  is  the  name  of  the  port  to  use  for  communication  with  the  graph¬ 
ics  display.  If  not  specified,  Caesar  makes  an  educated  guess  based  on  the  terminal 
from  which  it  is  being  run. 

-t  The  next  argument  is  the  name  of  the  port  to  use  for  reading  information  from  the 
graphics  tablet.  If  not  specified,  Caesar  makes  an  educated  guess  (usually  the  graphics 
port). 

-p  The  next  argument  is  a  search  path  to  be  used  when  opening  files. 

-B  The  next  argument  is  the  type  of  color  monitor  being  used,  and  is  used  to  select  the 

right  color  map  for  the  monitor’s  phosphors.  *std*  works  well  for  most  monitors, 
'pale*  is  for  monitors  with  especially  pale  blue  phosphor. 

-d  The  next  argument  is  the  type  of  display  controller  being  used.  Among  the  display 
types  currently  understood  are:  AED512,  UCBS12  (the  AEDS12  with  special  Berkeley 
PROMs  for  stippling),  AED767,  AED640  (an  AED767  configured  as  483x640  pixels), 
Omega440,  R9400,  or  Vectrix. 

When  Caesar  starts  up  it  looks  for  a  command  file  with  the  name  'xaesat*  in  the  home  direc¬ 
tory  and  processes  it  if  it  exists.  Then  Caesar  looks  for  a  xaesar  file  in  the  current  directory 
and  reads  it  as  a  command  file  if  it  exists.  The  xaesar  file  format  is  described  under  the  long 
command  source. 

You  generally  have  to  log  in  a  job  on  the  color  terminal  under  the  name  'sleepei*  (no  pass¬ 
word  required).  This  is  necessary  in  order  for  the  tablet  to  be  useable.  Sleeper  can  be  killed 
either  by  typing  two  control-backslashes  in  quick  succession  on  the  color  display  keyboard  (on 
the  AED  displays,  control-backslash  is  gotten  by  typing  control-shift-L),  or  by  invoking  the 
shell  command  killsleeper  with  the  correct  process  id.  On  some  systems  you  have  to  log  your¬ 
self  in  and  run  sleeper  as  a  shell  command.  On  still  other  qrstems  there  is  no  login  process  for 
the  color  display  port,  so  it  un’t  necessary  to  run  sleeper  at  all. 

The  four  buttons  on  the  graphics  tablet  puck  are  used  in  the  following  way: 
left  (white) 

Move  the  box  so  that  its  fixed  comer  (normally  lower-left)  coincides  with  the  crosshair 
position. 

right  (green) 

Move  the  box's  variable  comer  (normally  upper-ri^t)  to  coincide  with  the  crosdiair 
position.  The  fixed  comer  is  not  moved. 

top  (yellow) 

Find  the  cell  eontaining  the  crosshair  whose  lower-left  comer  is  closest  to  the 
crosshair.  Make  that  cell  the  current  cell.  If  the  button  is  depressed  again  without 
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moving  the  crosshair,  the  parent  of  the  current  cell  is  made  the  current  cell. 

b«ttom(blu) 

Paint  the  area  of  the  box  with  the  mask  layers  underneath  the  crosshair.  If  there  are 
no  mask  layers  visible  underneath  the  crosshair,  erase  the  area  of  the  box. 

SBORT  COMMANDS 

Short  commands  are  invoked  by  typing  a  single  letter  on  the  keyboard.  Valid  commands  are: 

a  Yank  the  information  underneath  the  box  into  the  yank  buffer.  Only  yank  the  mask 
layers  present  under  the  crosshair  (if  there  are  no  mask  layers  underneath  the 
crosshair,  yank  all  mask  layers  and  labels). 

e  Unexpand  current  cell  (display  in  bounding  box  form). 

d  Delete  paint  underneath  the  box  in  the  mask  layers  underneath  the  crosshair  (if  there 
ate  no  mask  layers  underneath  the  crosshair,  the  delete  labels  and  all  mask  layers). 

c  Move  the  box  up  1  lambda, 

g  Toggle  grid  on/off. 

I  Redisplay  the  information  on  both  text  and  graphics  screens, 
q  Move  the  box  left  1  lambda, 
r  Move  the  box  down  1  lambda. 

s  Put  back  (stuff)  all  the  information  in  the  yank  buffer  at  the  current  box  location. 

Stuff  only  information  in  mask  layers  that  are  present  underneath  the  crosshair  (if 
there  are  no  mask  layers  underneath  the  crosshair,  stuff  all  mask  layers  plus  labels). 

n  Undo  the  last  change  to  the  layout, 
w  Move  the  box  right  one  lambda. 

X  Unexpand  all  cells  that  intersect  the  box  but  don’t  contain  it. 
a  Zoom  in  so  that  the  area  underneath  the  box  fills  the  screen. 

C  Expand  current  cell  so  that  its  paint  and  children  can  be  seen. 

X  Expand  all  cells  that  intersect  the  box,  recursively,  until  there  are  no  unexpanded  cells 
intersecting  the  box. 

Z  Zoom  out  so  that  everything  on  current  screen  fills  the  area  underneath  the  box. 

5  Move  the  picture  so  that  the  fixed  comer  of  the  box  is  in  the  center  of  the  screen. 

6  Move  the  picture  so  that  the  variable  comer  of  the  box  is  in  the  center  of  the  screen. 

‘L  Redisplay  the  graphics  and  text  di^lays. 

.  Repeat  the  last  long  command. 

LONG  COMMANDS 

Long  commands  are  invoked  by  typing  a  colon  character  (’f).  The  cursor  will  appear  on  the 
bottom  line  of  the  text  terminal.  A  line  containing  a  command  name  and  parameters  should 
be  t]rped,  terminated  by  return.  Each  line  may  consist  of  multiple  commands  separated  by 
semi-colons  (to  use  a  colon  as  part  of  a  long  command,  precede  it  with  a  backslash).  Short 
commands  may  be  invoked  in  long  command  format  by  preceding  the  short  command  letter 
with  a  single  quote.  Unambiguous  abbreviations  for  command  names  and  parameters  are 
accepted.  The  commands  are: 
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•Ugn  <Kale> 

Change  crosshair  alignment  to  <scale>.  Crosshair  position  will  be  rounded  off  to 
nearest  multiple  of  <  scale> . 

array  <  iain>  <  yslxe> 

Make  the  current  cell  into  an  array  with  <xsize>  instances  in  the  x-direction  and 
<ysize>  instances  in  the  y-direction.  The  spacing  between  elements  is  determined  by 
the  box  X-  and  y-dimensions. 

array  <  xbot>  <  ybot>  <  xtop>  <  ytop> 

Make  the  current  cell  into  an  array,  numbered  from  <xbot>  to  <xtop>  in  the  x- 
direction  and  from  <ybot>  to  <ytop>  in  the  y-direction.  The  spacing  between 
array  elements  is  determined  by  the  box  x-  and  y-dimensions. 

box  <  kcyword>  <  anioant> 

Change  the  box  by  <amount>  lambda  units,  according  to  <keyword>.  If  <key- 
word>  is  one  of  'left*,  'right*,  'up*,  or  'down',  the  whole  box  is  moved  the  indicated 
amount  in  the  indicated  direction.  If  <  keyword>  is  one  of  'xbot*,  'ybot',  'xtop*,  or 
*ytop*,  then  one  of  the  coordinates  of  the  box  is  adjusted  by  the  given  amount. 

<  amount>  may  be  either  positive  or  negative. 

buttoa  <  Baiiiber>  <  x>  <  y> 

Simulate  the  pressing  of  button  <  number>  at  the  screen  location  given  by  <  x>  and 
<y>  (in  pixels).  If  <x>  and  <y>  are  omitted,  the  current  crosshair  position  is 
used. 

clf  -sbipx  <  aamO  <  •ealc> 

Write  out  a  CIF  description  of  the  layout  into  file  <name>  (use  edit  cell  name  by 
default;  a  'xir  extension  is  supplied  by  default).  <  scale>  indicates  how  many  cen- 
timicrons  to  use  per  Caesar  unit  (200  by  default).  The  -s  switch  causes  no  silicon 
(paint)  to  be  output  to  the  COF  file.  The  -b  switch  causes  bounding  boxes  to  be  drawn 
for  unexpanded  cells.  The  -1  causes  labeb  to  be  output.  The  -p  switch  causes  a  CIF 
point  to  be  generated  for  each  label.  The  -x  switch  causes  Caesar  not  to  automatically 
expand  ail  cells  (they  are  expanded  by  default). 

cload  <nic> 

Load  the  colormap  from  <  file> .  The  monitor  type  is  used  as  default  extension, 
clockwise  <dcgrccs>  [y] 

Rotate  the  current  cell  by  the  largest  multiple  of  90  degrees  less  than  or  equal  to 

<  degrees> .  <  degrees>  defaults  to  90.  If  the  command  is  followed  by  a  'y*  then  the 
yank  buffer  is  rotated  instead  of  the  current  cell. 

colormap  <laycrs> 

Print  out  the  red,  green,  and  blue  intensities  associated  with  <  layers> . 

colormap  <  layers>  <  rcd>  <  trccB>  <  blac> 

Set  the  intensities  associated  with  <  Iayers>  to  the  given  values. 

copycell 

Make  a  copy  of  the  current  cell,  and  position  it  so  that  its  lower-left  comer  coincides 
with  the  lower-left  comer  of  the  box. 

esave  <  nio 

Save  the  current  colormap  in  <  file>  (the  monitor  type  is  used  as  default  extension). 
dcIctcccU 

Delete  the  current  cell. 
cdItccU  <  fllo 

Edit  the  cell  hierarchy  rooted  at  <file>.  A  *xa*  extension  is  supplied  by  default.  If 
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information  in  the  current  hierarchy  has  changed,  you  are  given  a  chance  to  write  it 
out. 

eraaepalat  <laycrs> 

For  the  area  enclosed  by  the  box,  erase  all  paint  in  <  layers> .  If  <  layers>  is  omitted 
it  defaults  to  ”•1*. 

fill  <dlrcctloa>  <l^cn> 

<direction>  is  one  of  left*,  'right*,  *up*,  or  'down*.  The  paint  under  one  edge  of 
the  box  (reflectively,  the  right,  left,  bottom,  or  top  edge)  is  sampled;  everywhere  that 
the  edge  touches  paint,  the  paint  is  extended  in  the  given  direction  to  the  opposite 
side  of  the  box.  <  layers>  selects  which  layers  to  fill;  if  omitted  then  a  default  of  *«* 
is  used. 

flashccU 

Remove  the  definition  of  the  current  definition  from  main  memory  and  reload  it  from 
the  disk  version.  Any  changes  to  the  cell  since  it  was  last  written  are  lost. 

getccll<fllc> 

This  command  makes  an  instance  of  the  cell  in  <  file>  (a  *£a*  extension  is  supplied 
by  default)  and  positions  that  instance  at  the  current  box  location.  The  box  size  is 
changed  to  equal  the  bounding  box  of  the  cell. 

gridspacing 

The  grid  is  modified  so  that  its  spacing;i  in  x  and  y  equal  the  dimensions  of  the  box. 
The  grid  is  set  so  that  the  box  falls  on  grid  points. 

gripe  The  mail  program  is  run  so  that  comments  can  be  sent  to  the  Caesar  maintainer. 

height  <  slae> 

The  box’s  height  is  set  to  <  si2e> .  If  <  size>  is  preceded  by  a  plus  sign  then  the  fixed 
comer  is  moved  to  set  the  correct  height;  otherwise  the  variable  comer  is  moved. 
<  size>  defaults  to  2. 

Identlfycell  <  namc> 

The  current  cell  is  tagged  with  the  instance  name  given  by  <  name> .  This  feature  is 
not  currently  supported  in  any  useful  fashion.  <  name>  may  not  contain  any  white 
space. 

label  <  nanic>  <  posltion> 

A  rectangular  label  is  placed  at  the  box  location  and  tagged  with  <  name> .  <  name> 
may  not  contain  any  white  space.  <  position>  is  one  of  'center*,  left*,  'right*,  'top*, 
or  *bottom*;  it  specifies  where  the  text  is  to  be  displayed  relative  to  the  rectangle.  If 
omitted,  <  position>  defaults  to  'top*. 

lyra  <  mlcaaO 

The  program  *cad/bin/Iyra  is  ran,  and  is  passed  via  pipe  all  the  mask  features  within 
3k  of  the  box.  The  program  returns  labels  identifying  design  rale  violations,  and  these 
are  added  to  the  edit  cell.  If  <  ra!eset>  is  fiecifled,  it  is  passed  to  Lyra  with  the  >r 
switch  to  indicate  a  specific  raleset.  Otherwise,  the  current  technology  is  used  as  the 
raleset. 

■acre  < charaetcr>  <coamaad> 

The  given  long  command  is  associated  with  the  given  character,  such  that  whenever 
the  character  is  typed  u  a  short  command  then  the  given  command  is  executed.  This 
overrides  any  existing  definition  for  the  character.  To  clear  a  macro  definition,  type 
'macro  <  character>  *,  and  to  clear  all  macro  definitions,  type  'macro* 

aaark  <  niarkl>  <  ■arh2> 

The  box  is  Mved  in  the  mark  given  by  <markl>.  <markl>  must  be  a  lower-case 
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letter.  If  <  inark2>  is  specified,  the  box  is  changed  to  coincide  with  <  mark2> . 

moTccdl  <  kc]rward> 

The  current  cell  is  moved  in  one  of  two  ways,  selected  by  <  keyword> .  If  <  key- 
word>  is  *bypositioa*.  then  the  ceil  is  moved  so  that  its  lower-left  comer  coincides 
with  the  lower-left  comer  of  the  box.  This  also  happens  if  no  keyword  is  specified.  If 

<  keyword  >  is  'bysixe*.  then  the  cell  is  displaced  by  the  size  of  the  box  (this  means 
that  what  used  to  be  at  the  fixed  comer  of  the  box  will  now  be  at  the  variable  comer). 

paint  <  laycrs> 

The  area  underneath  the  box  is  painted  in  <  layers> . 

path  <  path> 

The  string  given  by  <path>  becomes  the  search  path  used  during  file  lookups. 

<  patb>  consists  of  directory  names  separated  by  colons  or  spaces.  Each  name  should 
end  in  */•. 

peck  <  laycrs> 

Di^lay  all  paint  underneath  the  box  belonging  to  <layers>.  even  for  unexpanded 
cells  and  their  descendants. 

popbox  <  aark> 

If  <  mark>  is  specified,  then  the  box  is  replaced  with  the  given  mark.  Otherwise  the 
box  stack  is  popped  and  the  top  stack  element  overwrites  the  box. 

poahbox  <  m»rk> 

The  box  is  pushed  onto  the  box  stack.  If  <mark>  is  specified  then  it  is  used  to 
overwrite  the  box.  otherwise  the  box  remains  unchanged. 

pat  <  layers> 

The  yank  buffer  iaformation  in  <layers>  is  copied  back  to  the  box  location.  If 

<  layers>  is  omitted,  it  defaults  to  '*51*. 

qalt  If  any  cells  have  changed  since  they  were  last  saved  on  disk,  the  user  is  given  a  chance 
to  write  them  out  or  abort  the  command.  Otherwise  the  program  returns  to  the  shell. 

reset  The  graphics  di^lay  is  reinitialized  and  the  colormap  is  reloaded. 

retara  The  current  subedit  is  left,  and  the  containing  edit  is  resumed. 

savecell  <  naaie> 

If  <  name>  is  specified  then  the  current  cell  is  given  that  name  and  written  to  disk 
under  the  name  (a  'xa*  extension  is  supplied  by  default).  If  <file>  isn’t  specified 
then  the  cell  is  written  out  to  the  disk  file  from  which  it  was  read. 

scroll  <  dlrcctlon>  <  aaioant>  <  aalts> 

The  current  view  is  moved  in  the  indicated  direction  by  the  indicated  amount. 

<  direction>  must  be  one  of  "left*.  ”right',  'up”,  or  'down*,  <  amount>  is  a  floating¬ 
point  number,  and  <units>  is  one  of  'screens*  or  'lambda*.  <units>  defaults  to 
'screens',  and  <  amount  >  defaults  to  03. 

search  <regezp> 

Search  labels  and  bounding  boxes  underneath  the  box  for  text  matching  <  regexp> . 
See  the  manual  entry  for  ed  for  a  description  of  <  regexp> .  Push  an  entry  onto  the 
box  stack  for  each  match.  Even  unexpanded  cells  are  searched. 

sideways  (y) 

Flip  the  current  cell  sideways  (i.e.  about  a  vertical  axis).  If  the  command  is  followed 
by  a  'y*  then  the  yank  buffer  is  flipped  instead  of  the  current  cell. 

soorce  <  fUenafliO 

The  given  file  is  read,  and  each  line  is  processed  as  one  long  command  (no  colons  are 
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necessary).  Any  line  whose  last  character  is  backslash  is  joined  to  the  following  line, 
sobcdit  Make  the  current  ceil  the  edit  cell,  and  edit  it  in  context, 
technology  <  fllO 

Load  technology  information  from  <file> .  A  '.tech'  extension  is  supplied  by  default. 

opsidedown  [y] 

Flip  the  current  cell  upside  down.  If  the  command  is  followed  by  a  'y'  then  the  yank 
buffer  is  flipped  instead  of  the  current  cell. 

usage  <  nie> 

Write  out  in  <file>  the  names  of  all  the  files  containing  cell  definitions  used  any¬ 
where  in  the  design  hierarchy. 

view  <  aiark> 

If  <mark>  is  specified,  set  view  to  it,  otherwise,  change  the  view  to  encompass  the 
entire  edit  cell. 

vlslblclayers  <  layers> 

Set  the  visible  layers  to  include  just  <Iayers>.  Preface  <layers>  with  a  plus  or 
minus  sign  to  add  to  or  remove  from  the  currently  visible  ones. 

width  <  alxc> 

Set  the  box  width  to  <  size>  (default  is  2).  Move  variable  comer  unless  width  is  pre¬ 
ceded  by  else  move  fixed  comer. 

wrlteall 

Run  through  interactive  script  to  write  out  all  cells  that  have  been  modified. 

yank  <  laycn> 

Save  in  the  yank  buffer  all  information  underneath  the  box  in  <  layers> .  <  layers> 
defaults  to 

ycdl  <  nanw> 

If  <name>  is  specified,  do  the  equivalent  of  'rgetcell  <name>'.  Then  expand 
current  cell,  yank  it,  delete  the  cell,  and  put  back  everything  that  was  yanked.  This 
flattens  the  hierarchy  by  one  level. 

ysava  <  namo 

Save  the  yank  buffer  contents  in  a  cell  named  <  name> .  A  'xa'  extension  is  provided 
by  default. 

LAYERS 

nMOS  mask  layers  are: 
p  or  r  Polysilicon  (red)  layer, 
d  or  g  Diffusion  (green)  layer, 
a  Metal  (blue)  layer. 

I  or  y  Implant  (yellow)  layer, 
h  Buried  eontact  (brown)  layer, 
c  Contact  cut  layer, 
o  Overglass  hole  (gray)  layer. 

0  Error  layer:  used  by  design  rale  eheckers  and  other  programs. 

CMOS  P-well  mask  layers  are  (using  technology  emos-pw): 
p  or  r  Polysilicon  (red)  layer. 
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d  or  g  Di^sion  (green)  layer, 
m  Metal  (blue)  layer, 

c  Contact  cut  layer. 

P  or  y  P-l-  implant  (pale  yellow)  layer, 
w  P-well  (brown  stipple)  layer. 

0  Overglass  hole  (gray)  layer. 

c  Error  layer:  used  by  design  rule  checkers  and  other  programs. 

Predefined  system  layers  are: 

•  All  mask  layers. 

1  Label  layer. 

S  Subcell  layer. 

C  Cursor  layer. 

G  Grid  layer. 

B  Background  layer. 


SYSTEM  MARKS 


nLES 


C  The  bounding  box  of  the  current  cell. 
E  The  bounding  box  of  the  edit  cell. 

P  The  previous  view. 

R  The  bounding  box  of  the  root  cell. 

V  The  current  view. 

*cad/new/caesar,  *cad/doc/caesar.tblms 


SEE  ALSO 

cif2ca(l) 

AUTHOR 

John  Ousterhout 

BUGS 
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NAME 

cdrc,  cdrcscript,  drc,  drcscript  -  CMC^-BULK  3  micron  and  NMOS  VLSI  design  rule  checkers 
SYNOPSIS 

cdrc  [-kn]  basenamejot 

cdrcscript  basename jcU  drc  [-ko]  basename.dl  [lambda] 
drcscript  basenamejot 

DESCRIPTION 

Cdre  analyzes  a  CMOS  CIF  file  for  geometric  rule  violations  using  MOSIS  cmos-bulk  3  micron 
process  rules.  Dre  analyzes  an  NMC^  CEP  file  for  geometric  rule  violations  using  MOSIS 
(buried  contact)  rules.  Both  cdrc  and  drc  are  limited  to  rectilinear,  orthogonal  geometry. 
Wires  are  taken  apart  into  rectangles,  and  round  Hashes  are  approximated  by  squares. 
Polygons  and  non-manhattan  rectangles  are  simply  ignored. 

The  options  are  as  follows: 

-k  Keep  around  all  intermediate  files. 

-a  Keep  around  files  of  unfiltered  error  messages. 

For  large  files,  cdrc  or  drc  should  be  run  in  batch  mode,  as  a  7000  transistor  chip  takes  over  2 
11/780  cpu  hours. 

When  cdrc  or  drc  find  violations,  they  create  CIF  files  of  rectangles  marking  the  geometric 
edges  involved.  These  markers  are  placed  on  the  error  layer  (CZ)  for  cdrc  and  on  the  glass 
layer  for  drc.  Separate  files  are  created  for  each  class  of  error,  named  tn^rrortypeJbasename. 

To  abort  cdrc  or  drc  hit  the  BREAK  key  and  wait  while  it  outputs  some  error  messages  until  it 
eventually  quits. 

{C)drcscript  will  merge  {c)drc  output  files.  labels  indicating  eiror  type,  and  the  original  CIF 
file  into  a  single  file,  drebasenamejOt.  If  this  file  is  processed  by  cif2ca  the  results  may  be 
viewed  with  caesar.  Errors  show  up  as  light  blue  boxes  in  the  error  layer  for  cdrc  or  as 
orange  boxes  in  the  glass  layer  for  drc.  Each  pair  of  boxes  involved  in  an  error  will  have  an 
associated  errortype  label  which  will  be  located  at  the  midpoint  between  the  centers  of  the 
two  boxes. 

MOSIS  CMOS/BULK  3  micron  process  rules  checked  by  cdrc: 


Errortype 

Microns 

Rule 

wWp 

3 

P-Well  width 

sWp 

9 

P-Well  to  P-Well  spacing  assuming  all  p-wells  are 
connected  to  vss 

dW 

4 

Diffusion  size 

dS 

4 

P4-  diffusion  to  P-f  diffusion  spacing 

4 

N-i-  diffusion  to  N-f  diffusion  spacing 

4 

N-l-  diffusion  to  P+  diffusion  spacing  outside  P-well 

4 

N-t-  diffusion  to  P-f  diffusion  spacing  inside  P-wcll 

pWp+DS 

8 

P-f  diffusion  in  N-substrate  to  P-well  edge  spacing 

Wpn+WnS 

7 

N-f  diffusion  in  N-substrate  to  P-wclI  edge  spacing 

pWn+DS 

4 

N-f  diffusion  in  P-well  to  P-well  edge  spacing 

pW 

3 

Poly  width 

ps 

3 

Poly  to  poly  spacing 

pSd 

2 

Field  poly  to  diffusion  spacing 

pOg 

3 

Poly  gate  extension  over  field 

gpSd 

3 

Gate  poly  to  diffusion  spacing 

p+Od 

2 

P-f  mask  overlap  of  diffusion 

2 

N-f  mask  to  P-f  diffusion  spacing 
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Tn+S 

3^ 

P-i-  mask  overlap  of  poly  in  diffusion 

p+S 

3 

P-t-  mask  to  P-t-  mask  spacing  in  diffusion 

3 

N-i-  mask  to  N-t-  mask  pacing  in  diffusion 

Enortype 

Microns 

Rule 

Dp+s 

2 

P-t-  mask  to  N-t-  diffusion  pacing 

2 

N-t-  mask  overlap  of  diffusion 

Tp+s 

3^ 

N-l-  mask  overlap  of  poly  in  diffusion  :  P-t-  mask  to 
poly  spacing  in  diffusion  inside  P-Well 

bcut 

Cut  must  have  metal  and  (poly  or  diffusion)  underneath 

wC 

3 

Contact  width 

cL 

8 

Maximum  contact  length 

cS 

3 

Contact  to  contact  spacing 

pOc 

2 

Poly  overlap  of  contact 

PMCz 

25 

Poly  overlap  of  contact  in  direction  of  metal 

cSpc 

3 

Contact  to  poly  channel  spacing 

mOe 

2 

Metal  oveilap  of  contact 

dOc 

2 

Diffusion  overlap  of  contact 

cp-H 

3 

Contact  to  P-f-  and  N-i-  mask  spacing 

scfp4- 

4 

Shorting  contact  extension  into  P-f  diffusion 

scfn-t- 

4 

Shorting  contact  extension  into  N-i-  diffusion 

mW 

3 

Metal  width 

mS 

4 

Metal  to  metal  qjacing 

in2w 

5 

Metal2  width 

m2S 

5 

Metal2  to  metal2  spacing 

c2w 

3 

Via  width 

c2S 

3 

Via  to  via  spacing 

m20c2 

25 

Metal2  extension  over  via 

mOc2 

25 

Metal  extension  over  via 

CC2s 

3 

Via-«ut  separation 

dOv 

3 

Diffusion  overlap  of  via 

dSv 

3 

Diffusion  to  via  spacing  when  they  dont  overlap 

pOv 

3 

Poly  overlap  of  via 

pSv 

3 

Poly  to  via  spacing  when  they  dont  overlap 

M2PSt 

1 

Metal2,  metal  and  poly  intersection  1  width 

MFMM2X 

4 

Metal  extension  over  the  above  intersection 

PPMM2X 

3 

Poly  extension  over  the  above  intersection 

PM2st 

5 

Metal2  metal  intersection(no  poly)  to  metal2  poly 
intersection(  with  no  metal )  spacing 

MPM2st 

5 

Metal2  poly  intersection  (no  metal)  to  metal  spacing 

PPM2st 

5 

Metal2  metal  intersection  (no  poly)  to  poly  spacing 

NMOS  rules  checked  by  drci 


Errortype 

Rule 

Lambda 

dS 

diffusion  spacing 

3i) 

iOg 

implant-gate  overlap 

15 

iSg 

implant-gate  spacing 

2Si 

pS 

poly  spacing 

20 

pOg 

poly-gate  overlap 

20 

pSd 

poly-diff  spacing 

10 

cS 

cut-cut  spacing 

20 

dcSg 

diff-cut  to  gate 

20 

mW 

metal  width 

iO 

iNOg 

implants  with  no  gates 
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xc 

cuts  with  no  D  or  P 

dW 

diffusion  width 

ZB 

ntdW 

non-xtr  ditt  width 

2B 

iS 

implant-implant 

15 

pW 

poly  width 

2J0 

gW 

gate  width 

2Ja 

cW 

cut  min  width 

2B 

cL 

cut  max  length 

6B 

mOc 

metal-cut  overlap 

IJ) 

dOc 

diff-cut  overlap 

IB 

pOc 

poly-cut  overlap 

IB 

sBP 

buried-poly  spacing 

2B 

sBD 

buried-diffusion  pacing 

2B 

oBD 

buried-diffusion  overlap 

2B 

oBU 

buried-contact  surround 

IB 

bW 

buried-contact  width 

2B 

SEE  ALSO 

caesar(cadl),  cif2ca(cadl) 

A  Geometric  Design  Rule  Checker,  Dorothea  Haken,  VLSI  Document  V0S3,  Carnegie  Mellon,  9 
June  1980. 

FILES 

basename.cif 

trr  Jtrrortypehasename 

drcbasenamecit 

enbasenamedt 

AUTHOR 

Dorothea  Haken  (CMU) 

BUGS 

The  poly-overlap-gate  check  fails  when  the  overlap  is  exactly  zero  {drc  only). 

Spacing  checks  do  not  consider  mutual  connectivity.  Sometimes  weird  things  will  happen,  and 
the  generated  spurious  errors  can  be  filteied  by  the  bin_filter  program,  which  examines  local 
connectivity.  Cuts  in  diffusion  or  poly  that  do  not  have  metal  covering  are  not  reported. 

Cuts  in  diffusion  or  poly  that  do  not  have  metal  covering  are  not  reported  {drc  only). 

Diagonal  spacing  checks  do  not  consider  the  true  diagonal  distance. 

SUGGESTIONS 

Do  not  have  basenames  beginning  with  a  number.  Otherwise,  this  leads  to  serious  errors  in 
that  edre  assumes  that  to  be  the  lambda  value. 

Try  to  have  as  short  a  basename  as  possible.  This  is  because  some  flavors  of  UNIX  restrict  the 
length  of  filenames.  Some  of  the  intermediate  files  that  are  generated  have  quite  long  names. 

The  default  lambda  is  50  centimicrons  for  the  edre  routines.  This  scaling  is  done  to  overcome 
the  inability  of  the  routines  to  check  for  non-integer  lambda  violations. 

It  is  advisable  to  run  {c]drc  in  the  background  (batch  mode),  directing  the  output  to  a  file,  so 
you  can  look  at  the  file  later  if  needed. 
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NAME 

cifZca  -  convert  CIF  files  to  caesar  files 
SYNOPSIS 

clf2c«  [  -1  lambda  ]  [  -t  tech  ]  {  -«  offset  ]  ciffile 
OESOtlPTION 

cif2ca  accepts  as  input  a  CIF  file  and  produces  a  caesar  file  for  each  defined  symbol.  Specify¬ 
ing  the  -I  lambda  option  scales  the  output  to  lambda  centi-microns  per  lambda.  The  default 
scale  is  200  centi-microns  per  lambda.  The  -t  tech  option  causes  layers  from  the  ^ecified 
technology  to  be  acceptable.  The  default  technology  is  nmos.  For  a  list  of  acceptable  techno¬ 
logies,  see  caesar  (1).  The  -o  offset  option  causes  all  CIF  numbers  to  be  incremented  by 
offset.  This  is  useful  when  the  Cff  numbers  are  used  for  Caesar  file  names,  and  when  several 
CIF  files  with  overlapping  numbers  are  to  be  joined  together  in  Caesar. 

Each  symbol  defined  in  the  CIF  file  creates  a  CAESAR  file.  By  default,  the  files  are  named 
“symbolffixa**,  where  m  is  the  CIF  symbol  number  (as  modified  by  the  -«  offset).  Symbols  can 
alM  be  named  with  a  user-extension  command,  giving  a  name  to  the  symbol  definition 
which  encloses  it.  CIF  commands  which  appear  outside  of  symbol  definitions  are  gathered  into 
a  symbol  called,  by  default,  ‘project’*,  and  are  output  to  the  CAESAR  file  “project .ca”. 

SEE  ALSO 

caesar  (i) 

DIAGNOSTICS 

Diagnostics  from  cif2ca  are  supposed  to  be  self-explanatory.  Each  diagnostic  gives  the  line 
number  from  the  input  file,  an  error  class  (informational,  warning,  fatal,  or  panic),  the  error 
message,  and  the  action  taken  by  cif2ca,  usually  to  ignore  the  CIF  command.  Informational 
messages  usually  refer  to  limitations  of  cif2ca.  Warning  messages  usually  refer  to  inconsisten¬ 
cies  in  the  cif  file,  these  will  typically  result  in  caesar  files  which  do  not  accurately  reflect 
the  input  CIF  file.  Fatal  messages  refer  to  fatal  inconsistencies  or  errors  in  the  CIF  file.  A  fatal 
error  terminates  cif2ca  processing.  Panic  messages  refer  to  internal  problems  with  cif2ca.  If 
any  diagnostics  are  produced,  a  summary  of  the  diagnostics  is  produced. 

AUTHOR 

Peter  B.  Kessler,  bug  fixes  and  new  features  by  John  Ousterhout  and  Steve  Rubin. 

BUGS 

“Delete  Definitions”  commands  are  not  implemented.  cif2ca  also  has  certain  restrictions  due 
to  restrictions  of  caesar:  e.g.  non-manhattan  objects  are  not  allowed. 

Library  cells  are  not  automagically  included. 

Some  care  should  be  taken  in  naming  symbols,  since  symbol  names  are  used  for  caesar  file 
names.  Names  which  are  not  unique  in  the  first  14  characters  will  attempt  to  create  the  same 
CAESAR  file,  and  only  the  last  one  wins.  Similarly,  one  should  avoid  trying  to  have  two 
projectxa  files  in  the  same  directory. 
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NAME 

cifplot  -  CIF  interpreter  and  plotter  for  displaying  VLSI  circuits 
SYNOPSIS 

cifplot  [options]  fiteIxU  \file2jctt  ...] 

DESCRIPTION 

Cifplot  takes  a  description  in  Cal*Tech  Intermediate  Form  (CIF)  and  produces  a  plot.  CIF  is 
a  loW'Ievel  graphics  language  suitable  for  describing  integrated  circuit  layouts.  Although  CIF 
can  be  used  for  other  graphics  applications,  for  ease  of  discussion  it  will  be  assumed  that  CIF 
is  used  to  describe  integrated  circuit  designs.  Cifplot  interprets  any  legal  CIF  2.0  description 
including  symbol  renaming  and  Delete  Definition  commands.  In  addition,  a  number  of  local 
extensions  have  been  added  to  CIF,  including  text  on  plots  and  include  files.  These  are  dis¬ 
cussed  later.  Care  has  been  taken  to  avoid  any  arbitrary  restrictions  on  the  CIF  programs  that 
can  be  plotted. 

To  get  a  plot  call  cifplot  with  the  name  of  the  CIF  file  to  be  plotted.  If  the  CIF  description  is 
divided  among  sever^  files  call  cifplot  arith  the  names  of  all  files  to  be  used.  Cifplot  reads  the 
CIF  description  from  the  files  in  the  order  that  they  appear  on  the  command  line.  Therefore 
the  CIF  End  command  should  be  only  in  the  last  file  since  cifplot  ignores  everything  after  the 
Ei^  command.  After  reading  the  CIF  description  but  before  plotting,  cifplot  will  print  a  esti¬ 
mate  of  the  size  of  the  plot  and  then  ask  if  it  should  continue  to  produce  a  plot.  Type  y  to 
proceed  and  n  to  abort.  A  typical  run  might  look  as  follows; 

%  dfplet  Ub,clf  sorter .df 
Window  -5700  174000  -76500  168900 
Scale:  1  micron  is  OJ0O4O75  inches 
The  plot  will  be  0.610833  feet 
Do  you  want  a  plot?  y 

After  typing  y  cifplot  will  produce  a  plot  on  the  Benson-Varian  plotter. 

Cifplot  recognizes  several  command  line  options.  These  can  be  used  to  change  the  size  and 
scale  of  the  plot,  change  default  plot  options,  and  to  select  the  output  device.  Several  options 
may  be  selected.  A  dash(-)  must  precede  each  option  specifier.  The  follow,  lug  is  a  list  of 
options  that  may  be  included  on  the  command  line: 

-w  xmin  xmax  ymin  ymax 

(window)  This  option  specifies  the  window;  by  default  the  window  is  set  to  be  large 
enough  to  contain  the  entire  plot.  The  windowing  commands  lets  you  plot  just  a  small 
section  of  your  chip,  enabling  you  to  see  it  in  better  detail.  Xmin,  xmax,  ymin,  and 
ymax  should  be  specified  in  CIF  coordinates. 

-s  float 

(scale)  This  option  sets  the  scale  of  the  plot.  By  default  the  scale  is  set  so  that  the 
window  will  fill  the  whole  page.  Float  is  a  floating  point  number  qiecifying  the 
number  of  inches  which  represents  1  micron.  A  recommended  size  is  0j02. 

-1  layerlist 

(layer)  Noimally  all  layers  are  plotted.  This  option  specifies  which  layers  NOT  to  plot. 
The  It^erllst  consists  of  the  layer  names  separated  by  commas,  no  spaces.  There  are 
some  reserved  names:  allTcxt,  bbex,  eatilnc,  text,  pelntNamc,  and  symbelName. 
Including  the  layer  name  allTcxt  in  the  list  suppresses  the  plotting  of  text;  bbox 
suppresses  the  bounding  box  around  symbols,  outline  suppresses  the  thin  outline  that 
borders  each  layer.  The  keywords  text,  poIntNamc.  and  symbolName  suppress  the 
plotting  of  certain  text  created  by  local  extension  commands,  text  eliminates  text 
created  by  user  extension  2.  polatName  eliminates  text  created  by  user  extension  94. 
symbolName  eliminates  text  created  by  user  extension  9.  aUTcxt,  poIntName,  and 
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s^mbolNam*  may  be  abbreviated  by  at.  pn.  and  m  repcctively. 

-t  R  (ceplca)  Makes  n  copies  of  the  plot.  Works  only  for  the  Varian  and  Versatec.  Default 
is  1  copy. 

-d  R  (depth)  This  option  lets  you  limit  the  amount  of  detail  plotted  in  a  hierarchically 
designed  chip.  It  will  only  instandate  the  plot  down  r  levels  of  calls.  Sometimes  too 
much  detail  can  hide  important  features  in  a  circuit. 

••g  R  (grid)  Draw  a  grid  over  the  plot  arith  spacing  every  r  CIF  units. 

^h  (half)  Plot  at  half  normal  resolution.  (Not  yet  implemented.) 

>e  (catcndoBs)  Accept  only  standard  CIF.  User  eitensions  produce  warnings. 

>[  (noa-Iatcractlve)  Do  not  ask  for  confirmation.  Always  plot. 

"L  (List)  Produce  a  listing  of  the  CIF  file  on  standard  output  as  it  is  parsed.  Not  recom¬ 
mended  unless  debugging  hand-coded  CIF  since  CIF  code  can  be  rather  long. 

^a  R  (appmlaude)  Approximate  a  roundfiash  with  an  R-sided  polygon.  By  default  r  equals 
8.  (Ije.  roundfla^es  are  approximated  by  octagons.)  If  r  equals  0  then  output  circles 
for  roundflashes.  (It  is  best  not  to  use  full  circles  since  they  significantly  riow  down 
plotting.)  (Full  circlet  not  yet  implemented.) 

-h  •/exr' 

(banner)  Print  the  text  at  the  top  of  the  plot. 

-C  (Comments)  Treat  comments  as  though  they  were  spaces.  Sometimes  CIF  files  created 
at  other  universities  will  have  several  enots  due  to  syntactically  incorrect  comments. 
(I.e.  the  comments  may  appear  in  the  middle  of  a  CDF  command  or  the  comment  does 
not  end  with  a  semi-colon.)  Of  course,  CIF  files  should  not  have  any  errors  and  these 
comment  related  errors  must  be  fixed  before  transmitting  the  file  for  fabrication.  But 
many  times  fixing  these  errors  seems  to  be  more  trouble  than  it  is  worth,  especially  if 
you  just  want  to  get  a  plot.  This  option  is  useful  in  getting  rid  of  many  of  these  com¬ 
ment  related  syntax  errors. 

>r  (rotate)  Rotate  the  plot  90  degrees. 

-N  (Prlntronlx)  Send  output  to  the  Printronix. 

-V  (Varian)  Send  output  to  the  Varian.  (This  is  the  default  option.) 

-W  (Wide)  Send  output  directly  to  the  Versatec. 

-S  (Spool)  Store  the  output  in  a  temporary  file  then  dump  the  output  quickly  onto  the 
Versatec.  Makes  nice  crisp  plots;  also  takes  up  a  lot  of  disk  space. 

-T  (Terminal)  Send  output  to  the  terminal.  (Not  yet  fully  implemented.) 

-Gh 

-Ga  (Graphics  terminal)  Send  output  to  terminal  using  it’s  graphics  capablities.  -Gh  indi¬ 
cates  that  the  terminal  is  an  HP2648.  -Ga  indicates  that  the  terminal  is  an  AED  S12. 

-X  batename 

(extractor)  From  the  CIF  file  create  a  circuit  description  suitable  for  switch  level 
simulation.  It  creates  two  files:  batenameMm  which  contains  the  circuit  description, 
and  batename  Modt  which  contains  the  node  numbers  and  their  location  used  in  the 
circuit  description. 

When  this  option  is  invoked  no  plot  is  made.  Therefore  it  is  advisable  not  to  use  any 
of  the  other  options  that  deal  only  with  plotting.  However,  the  -w,  -I,  and  -a  options 
are  still  appropriate.  To  get  a  plot  of  the  circuit  with  the  node  numbers  call  cifplot 
again,  without  the  -X  option,  and  include  harenoRie modes  in  the  list  of  CIF  files  to  be 
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plotted.  (This  file  must  appear  in  the  list  of  files  before  the  file  with  the  GIF  End 
command.) 

-e  H  (copies)  This  option  specifies  the  number  of  copies  of  the  plot  you  would  like.  This 
allows  you  to  get  many  copies  of  a  plot  with  no  extra  computation. 

-P  panerirfile 

(Pattern)  This  option  lets  you  specify  your  own  layers  and  stipple  patterns.  Patterirfile 
may  contain  an  arbitrary  number  of  layer  descriptors.  A  layer  descriptor  is  the  layer 
name  in  double  quotes,  followed  by  8  integers.  Each  integer  specifies  32  bits  where 
ones  are  black  and  zeroes  are  white.  Thus  the  8  integers  specify  a  32  by  8  bit  stipple 
pattern.  The  integen  may  be  in  decimal,  octal,  or  hex.  Hex  numbers  start  with  ’Ox’; 
octal  numbers  start  with  ’O’.  The  GIF  qmtax  requires  that  layer  names  be  made  up  of 
only  uppercase  letters  and  digits,  and  not  longer  than  four  characters.  The  following 
is  example  of  a  layer  description  for  poly*silicon: 

'NP'  0x08080808  0x04040404  0x02020202  0x01010101 
0x80808080  0x40404040  0x20202020  0x10101010 

-P  foKtfUenama 

(Font)  This  option  indicates  which  font  you  want  for  your  text.  The 
foiufiteH  ame  must  be  in  the  directory  lu$riliblvfoitt.  The  default  font  is  Roman 
6  point.  Obviously,  this  option  is  only  useful  if  you  have  text  on  your  plot. 

-O  filename 

(Ontpot)  After  parsing  the  GIF  files,  store  an  equivalent  but  easy  to  parse  GIF 
description  in  the  specified  file.  This  option  removes  the  include  and  array  commands 
(see  next  section)  and  replaces  them  with  equivalent  standard  GIF  statements.  The 
resulting  file  is  suitable  for  transmission  to  other  facilities  for  fabrication. 

In  the  definition  of  GIF  provisions  were  made  for  local  extensions.  All  extension  commands 
begin  with  a  number.  Part  of  the  purpose  of  these  extensions  is  to  test  what  features  would 
be  suitable  to  include  as  part  of  the  standard  language.  But  it  is  important  to  realize  that 
these  extensions  are  not  standard  GIr  and  that  many  programs  interpreting  GIF  do  not  recog¬ 
nize  them.  If  you  use  these  extensions  it  is  advisable  to  create  another  GIF  file  using  the  -O 
options  described  above  before  submitting  your  circuit  for  fabrication.  The  following  is  a  list 
of  extensions  recognized  by  cifplot. 

01  filename  i 

(Inclndc)  Read  from  the  specified  file  as  though  it  appeared  in  place  of  this  command. 
Include  files  can  be  nested  up  to  6  deep. 

OA  s  mndxdy 

(Array)  Repeat  symbol  a  m  times  with  dx  spacing  in  the  x-direction  and  n  times  with 
dy  spacing  in  the  y-direction.  a.  m,  and  n  are  unsigned  integers,  dx  and  dy  are  signed 
integers  in  GIF  units. 

1  meaaagei 

(Print)  Print  out  the  message  on  standard  output  when  it  is  read. 

2  'text*  tranaform ; 

2C  *texf  tranrform  ; 

(Text  on  Plot)  Text  is  placed  on  the  plot  at  the  position  specified  by  the  transforma¬ 
tion.  The  allowed  transformations  are  the  same  as  the  those  allowed  for  the  Gall  com¬ 
mand.  The  transformation  affects  only  the  {mint  at  which  the  beginning  of  the  text  is 
to  appear.  The  text  is  always  plotted  horizontally,  thus  the  mirror  and  rotate  transfor¬ 
mations  are  not  really  of  much  use.  Normally  text  is  placed  above  and  to  the  right  of 
the  reference  point.  The  2C  command  centers  the  text  about  the  reference  point. 
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9  namei 

(Name  aymbol)  name  is  associated  with  the  current  symbol. 

M  namexy; 

94  namexy  layer; 

(Name  point)  name  is  associated  with  the  point  (x,  y).  Any  mask  geometry  crossing 
this  point  is  also  associated  with  none.  If  layer  is  present  then  just  geometry  crossing 
the  point  on  that  layer  is  associated  with  name.  For  plotting  this  command  is  similar 
to  text  on  plot.  When  doing  circuit  extraction  this  command  is  used  to  give  an  explicit 
name  to  a  node.  Name  must  not  have  any  q>aces  in  it,  and  it  should  not  be  a  number. 

nLES 

'cad/£adrc 

'/.cadre 

'cad/bin/vdump 
Just/  lib/vfont/Rii 
/usr/tmp/#cif« 

SEB  ALSO 

cadrc(cad5) 

A  Guide  to  LSI  Implementation,  Hon  and  Sequin,  Second  Edition  (Xerox  PARC,  1980)  for  a 
description  of  CIF. 

AUTHOR 

Dan  Fitzpatrick  (UCB) 

MOOmCATlONS 

(UW/NW  VLSI  Consortium,  University  of  Washington) 

BUGS 

The  HT  is  somewhat  kludgy  and  does  not  work  well  with  the  other  options.  Space  before 
semi-colons  in  local  extensions  can  cause  syntax  errors. 

The  -O  option  produces  simple  cif  with  no  scale  factors  in  the  DS  commands.  Because  of  this 
you  must  supply  a  scale  factor  to  some  programs,  such  as  the  -I  option  to  cif2ca. 

The  ~X  option  does  not  work  for  non-manhattan  circuits. 
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NAME 

decNor  -  Generates  CMOS  dynamic  NOR  form  decoder  layouts. 

SYNOPSIS 

decNor  [t^tioiu]  Inpata  [OiaFile] 

DESCRIPTION 

DecNor  is  a  program  for  generating  CMOS  dynamic  NOR  form  decoder  layouts  in  the  'caesar* 
format.  DecNor  constructs  caesar  composition  cells  from  caesar  leaf  cells  and/or  other  compo¬ 
sition  cells.  All  caesar  cells  reside  in  the  7ca  directory.  Leaf  ceils  have  names  of  the  form 
decNor_«£a  while  composition  cells  have  names  of  the  form  *OutFile**xa.  Leaf  cells  must  be 
copied  from  $UW_VLSI_TOOLS/lib/generaton/decNor  into  7ca  before  running  decNor.  The 
completed  layout  resides  in  *OutFite*xa.  Inpots  are  the  number  of  inputs  to  the  decoder. 
”OutFile*  can  not  begin  with  the  string  'decNor*.  The  default  for  'OutFile*  is  the  string 
'decGen*. 

As  decNor  is  a  cfl-based  program  it  creates  files  of  the  form  o.bd  in  Jet. 

The  following  table  describes  decNor’s  options  although  an  abreviated  listing  can  be  obtained 
by  invoking  decNor  with  no  arguments.  Options  prepended  by  '•*  are  active  while  those  with 
'•*  have  not  been  implemented. 

-f  Stripped  down  layout  for  floor  planning.  Cells  which  occupy  a  large  part  of  the 
decoder  are  represented  in  dummy  layers  allowing  faster  layout  generation. 

-t  Layout  of  worst  case  path  for  timing  estimates.  Cells  which  are  not  part  of  the 
slowest  electrical  path  are  represented  in  dummy  layers  allowing  faster  generation, 
extraction  and  simulation. 

-s  A  schematic  of  the  decoder.  Ceils  are  represented  as  symbols  (wires  and  transistors) 
drawn  in  black  ink  (labels)  on  a  yellow  background  (P-t-  mask). 

•p  P'type  decode  transistors.  Since  N-type  transistors  have  a  lower  on  resistance  they  are 
the  default  decode  transistor  type. 

-I  Labels  are  added  to  inputs  and  outputs.  Since  labels  increase  the  generation  time  they 
are  not  added  as  the  default.  When  included  they  are  prepended  with  "OutFile”. 

-b  banks 

The  array  of  decode  transistors  will  be  repeated  '  banks  '  times.  This  feature  can  be 
used  to  distribute  decoder  outputs  to  a  number  of  places  with  minimal  additional  area. 
Default  is  one. 

*o  outs 

Stretch  decoder  to  give  *  outs  *  lambda  output  spacing.  This  option  simplifies  connec¬ 
tion  by  abutment. 

*1  ins 

Grow  decode  xsistors  to  give  "ins  "  lambda  input  spacing.  This  option  allows  the 
decoder  to  operate  faster. 

•V  ver 

Grow  input  inverten  to  fill  vertical  size  of  ’  ver  "  lambda.  This  option  allows  the 
decoder  to  operate  faster. 

•b  hor 

Grow  evaluate/charge  xsistors  to  fill  horizontal  size  of  *  hor  *  lambda.  This  option 
allows  the  decoder  to  operate  faster. 
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FILES 

yca/OutFiIe«xa 

yca/OutFiIe*Jxi 

7ca/decNor_*.ca 

SEE  ALSO 

caesar(CADl),  cfl(S.vIsi) 

AUTHORS 

David  J.  Morgan 


UW/NW  VLSI  Release  2 


2 


6/1/84 


EQNTOTT(l) 


UNIX  Programmer’s  Manual 


EQNTOTT(l) 


NAME 

eqntott  -  generate  truth  table  from  Boolean  equations 
SYNOPSIS 

eqntott  [  *1 H  -f  ]  [  •§  H  'C  ]  ( •£  ]  ]  ( •  Jtey  ]  [  cc  options  ]  [  files  ] 

ASCRIPTION 

Eqntott  generates  a  truth  table  suitable  tor  PLA  programming  from  a  set  of  Boolean  equations 
which  define  the  PLA  outputs  in  terms  of  its  inputs.  When  neither  -f  nor  -s  is  specified,  input 
and  output  variables  must  be  mutually  exclusive.  If  the  -s  option  is  given,  an  output  variable 
may  be  used  in  an  expression  defining  another  output  variable:  the  expression  for  the  first  out¬ 
put  is  substituted  for  the  the  name  of  that  output  when  it  is  encountered.  The  -f  option 
allows  outputs  to  be  defined  in  terms  of  their  previous  values  in  a  synchronous  system  (e.g.  an 
FSM):  the  same  name  appearing  as  both  an  input  and  an  output  may  be  thought  of  m  refer¬ 
ring  to  two  distinct  variables,  or  the  same  variable  at  two  distinct  times.  (The  -f  and  -s 
options  are  mutually  exclusive.) 

If  the  -r  option  is  specified,  eqntott  will  attempt  to  reduce  the  size  of  the  truth  table  merg¬ 
ing  minterms.  The  -R  option  (implies  -r)  forces  eqntott  to  produce  a  truth  table  with  no 
redundant  minterms.  The  truth  table  generated  does  not  represent  a  minimal  covering  of  the 
truth  functions,  but  does  preserve  some  "don’t  care*  information  for  some  other  program  to 
use. 

If  the  -1  option  is  specified,  eqntott  will  output  a  truth  table  which  includes  the  name  of  the 
pla  and  its  inputs  and  outputs  as  specified  in  PLA(S). 

The  form  that  the  output  takes  is  controlled  by  the  string  key,  described  below.  Input  is  taken 
from  files  (standard  input  default)  and  tun  through  the  C  macro  preprocessor  of  ee(l),  to  per¬ 
mit  comments,  file  inclusion,  macros,  and  conditional  processing.  The  cc  options  -D,  -I,  and  -U 
are  recognized  and  passed  on  to  the  preprocessor. 

EqeatiM  Sjntau 
name  »  expression; 

Asmiates  a  truth  function  defined  by  expression  with  the  output  name,  both  of  which 
ate  defined  below.  If  an  output  name  is  assigned  more  than  one  expression,  the  effect 
is  identical  to  a  single  assignment  to  the  output  of  the  logical  disjunction  of  all  the  ori¬ 
ginal  expressions. 

NAME  *=  name  ; 

Defines  the  name  of  the  pla  to  be  "name*.  If  not  specified,  the  name  of  the  pla  is  the 
name  of  the  input  file  with  any  postfixes  removed. 

INORDER  »  name  [name]... ; 

Defines  the  order  in  which  inputs  appear  in  the  truth  table.  If  not  specified,  the  order 
is  that  in  which  the  inputs  appear  in  the  source. 

OUTORDER  >■  name  [name]... ; 

Defines  the  order  in  which  outputs  appear  in  the  truth  table.  If  not  specified,  the 
order  is  that  in  which  the  outputs  appear  in  the  source. 

Eiprurise  Syntax: 
name 

A  name  is  used  to  specify  an  input  or  output.  The  name  must  begin  with  a  letter  or 
underscore;  subsequent  characters  may  be  letters,  digits,  underscores,  asterisks, 
periods,  square  brackets,  or  angle  brackets. 
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ZERO  (or  0) 

Builtin  input  that  always  has  the  value  zero  (false). 

ONE  (or  1) 

Builtin  input  that  always  has  the  value  one  (true). 

? 

Builtin  input  that  always  has  the  value  'don’t  care*. 

(  expression  ) 

Parenthesis  may  be  used  to  change  the  order  of  evaluation. 

!  expression 

Gives  the  complement  of  expression. 
expression  St  expression 

Gives  the  logical  conjunction  of  the  two  expressions.  The  &  operator  associates  left  to 
right,  and  has  the  same  precedence  as  L 

expression  I  expression 

Gives  the  logical  disjunction  of  the  two  expressions.  The  I  operator  also  associates  left 
to  right,  and  has  a  lower  precedence  than  A. 

Oatput  Termnt 

The  output  format  may  be  controlled  to  a  small  extent  using  the  character  string  key.  The 
string  is  scanned  left  to  right,  and  at  each  character  code,  a  piece  of  output  is  generated 
corresponding  to  the  character  encountered.  If  -itey  is  not  specified,  the  string  'iopte*  is  used, 
or  'iopfte'  with  the  -t  option. 

code  outpns  generased 

•  .e 

f  .f  outpnS-nnmber  inpM-nnmber 

(one  line  for  each  feedback  path,  numbers  refer  to  Or-  and  And-plane  truth  table 
column  numbers) 

h  a  human  readable  version  of  the  truth  table  (q.v.) 

1  .1  number-qf -inputs 

I  .1  input-name 

(one  line  tor  each  input,  in  order) 

I  a  truth  table  with  the  name  of  the  pla,  its  inputs  and  its  outputs 
p  .p  number-of -produet-terms 

B  Jl  number-qf  -product-terms 

0  JS  number-of -outputs 

O  .O  output-name 

(one  line  for  each  output,  in  order) 

S  PLA  connectivity  summary 

t  PLA  personality  matrix  (q.v.) 

V  eqntott  version  information 

The  truth  table  (personality  matrix)  consists  of  a  line  for  each  minterm,  beginning  with  that 
minterm  and  followed  by  the  values  of  the  various  outputs.  The  minterm  is  composed  of  a 
single  character  (0, 1,  or  •)  for  each  input  in  the  conventional  fashion.  The  output  values  are 
represented  by  one  of  the  three  characters  (0,  1,  or  x).  Some  white  space  is  added  for 
readability’s  sake. 
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In  the  human  readable  format,  each  line  of  output  represents  one  term  in  the  sum-of-products 
expression  for  an  output.  The  line  begins  with  the  name  of  the  output,  which  is  enclosed  in 
parentheses  for  the  value  'don’t  care*.  Then  follow  the  names  of  the  inputs  in  the  product; 
complemented  inputs  are  preceded  by  a  I. 

SEE  ALSO 

cc(l). 

DIAGNOmCS 

Syntax  errors  are  written  to  the  standard  error  output  and  should  be  self-explanatory. 

BUGS 

-I  should  be  the  default,  but  some  pla  tools  can’t  handle  the  full  format.  Eqntott  likes  its 
option  seperately;  ije.  -f  -I  works  but  -fl  doesn’t. 

AUTHOR 

Bob  Cmelik. 

•I  option  added  by  Jeff  Deutsch. 
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NAME 

gen_control  -  generate  a  control  file  for  RNL 

SYNOPSIS: 

gcn_control 
(no  arguments) 

INSCRIPTION 

gen_control  is  a  program  designed  to  quickly  specify  a  control  file  for  RNL  simulation. 
gen_controt  provides  for  the  proper  insertion  of  quotes  and  use  of  parenthesis. 

Typical  file  extensions  to  the  basenames  are  assumed. 

When  starting  up  the  genj:oiuroi  program,  the  user  will  be  prompted  for  the  necessary 
information  to  be  provided. 

Assumed  standard  libraries  are: 

awatdJ  A  awatinJ 


Prompts: 

1.  Basename: 

The  control  file  will  be  written  in:  basenameJ 
In  the  J  or  control  file  assumed  extensions  are: 
for  the  log  file:  basename  slog 
for  the  network:  basename 
for  the  plotfile:  basename Jieb 

2.  Comment: 

A  one  line  comment,  which  could  be  a  short  comment  about  the  simulated  circuit  can  be 
entered. 

3.  Simulation  step  increment  value: 

Enter  the  value  of  the  simulation  step  in  0.1  ns  units.  The  appropriate  lisp  command  is 
automatically  generated. 

4.  Definition  of  normal  vectors: 

To  define  a  vector  enter  its  name. 

Then  there  will  be  a  prompt  for  its  type  (bit,  bin,  oct,  hex,dec) 

Followed  by  a  prompt  for  its  elements. 

A  <  CR>  means  skip  this  entry. 

5.  Definition  of  single  indexed  vectors: 

Enter  basename  and  after  prompts:  type,  start  index  and  number  of  elements. 

6.  Definition  of  a  set  at  double  indexed  vectors: 

Enter  basename  and  after  prompts:  type,  indexsizel  and  indexsize2. 

7.  Definition  of  report  for  end  of  simulation  step: 

One  of  two  types  can  be  specified: 

Just  a  <  CR>  specifies  the  normal  def-report  contents; 

<any  characterx  CR>  specifies  an  optional  type  in  which  multiple  vectors  with  double 
indexed  nodes  can  be  specified. 

Next  there  will  be  a  prompt  for  a  comment  to  be  included  in  every  report  (this  portion  only  is 
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optional). 

Then  there  will  be  prompting  until  a  <  CR>  is  entered  for 

nodenames  (just  enter  the  names)  or 
a  vector  name  (first  enter  Vec’  and  then  the  name). 

In  case  of  the  optional  report  format,  the  multiple  vector  specification  format  is  obtained  by 
reponding  with  Veci*.  Additional  prompts  will  follow  for  basename  and  size. 

8.  Selection  of  output  mode:  logic  analyzer  style  output: 

Enter  any  character  for  selecting  logic  analyzer  style  output  and  a  <  CR>  for  standard  out¬ 
put. 

A  report  stating  the  order  of  columns  in  the  output  of  RNL  will  be  automatically  generated. 

9.  Selection  of  output  mode:  glitch  detection  reporting: 

Enter  any  character  for  selecting  glitch  detection  and  a  <CR>  for  standard  reporting  of 
transients. 

10.  Definition  of  nodes  with  transient  or  glitch  reporting: 

Individual  node  names,  vectors  with  single  indexed  node  names  and  vectors  with  double 
indexed  node  names  can  be  specified.  Respond  appropriately  for  names  vectorsizes. 

11.  Definition  of  logic  trigger  conditions: 

There  are  prompts  for  defining  trigger  conditions  on  individual  node  names,  single  vectors  in 
invec  i,pc  format,  and  single  vectors  in  bitinvec  type  format. 

12.  Definition  of  additional  RNL  simulation  set-up  commands: 

Enter  the  desired  RNL  commands.  Terminate  with  an  additional  <  CR> . 

13.  Definition  of  a  timing  pattern  file: 

Respond  with  <  CR>  if  there  is  no  such  file  (unlikely)  or  any  other  character  if  such  is  the 
case. 

The  filename  assumed  is:  basenamc.ttiiw 

14.  Definition  of  wrap-up  RNL  commands: 

Enter  the  desired  simulation  wrap-up  commands  (often  just  ’exit’). 

There  is  no  syntax  checking  in  gen  contrcl.  gen_cofttrol  will  put  the  quotes  and  parentheses  at 
the  right  places.  Any  errors  can  be  easily  corrected  using  a  standard  text  editor  on  the  output 
file:  basename  J. 

This  file  can  be  inspected  for  correctness.  Errors  may  be  reported  by  RNL  when  running  the 
simulation. 

HLES 

The  output  file  is  an  ascii  file  and  can  be  inspected.  The  files  containing  the  library  functions, 
network  etc.  must  be  at  the  correct  place. 

uwstdJ,  uwsimJ,  basenameJ.  basename.  basename xlog,  basenameJbeh,  basename sime 
SEE  ALSO 

genjime  manual  instructions 
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AUTHOR 

Henriecus  Koeman,  John  Fluke  Mfg.  Co.,  Inc. 

DIAGNOSICS 

none 

BUGS 

Please  let  the  author  know. 
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NAME 

gen_tinie  -  generate  a  stimulus  pattern  for  ml. 

SYNOPSIS 

genjime  Input JiU  output JUe 
DESCRIPTION 

genjime  is  a  program  designed  to  quickly  specify  input  signal  patterns  which  can  be  read  by 
the  lisp  command  interpreter  of  RNL.  gen_time  accepts  a  simple  syntax  without  quotes  and 
parentheses  and  accepts  a  simple  means  for  defining  states  or  commands  for  specific  moments 
in  time.  The  output  of  gen_time  is  typically  read  by  the  main  control  file,  which  contains  the 
set-up  information  for  the  simulation.  This  control  file  can  easily  be  obtained  using  the 
gen_control  program.  One  of  the  commands  should  'load*  the  outputfile  of  gen_time. 


Syntax  summary; 

timejange  <  start_time>  <  8top_time> 

(must  be  the  first  command) 

nodejuune  <pctioA>  <statel>  <timcl>  <state2>  <timc2>  ... 

inyec  <vector_ttame>  <pcriod>  <valucl>  <timel>  _ 

bitinvec  <vector_namc>  <pcriod>  <bitvaluesl>  <timel>  _ 

(note  no  spaces  between  individual  bitvalues  as  in  the 
equivalent  ml  command.') 

commu/id  <  period >  <  mI_commandl>  <timel>  _ 

(no  alternate  syntax  allowed  in  rai_commands  here) 
report  <period>  <timel>  <time2>  ..... 

(report  1  0  generates  a  report  after  every  time 
step) 

(must  be  the  last  command  in  the  input_file) 
m(uk<  period>  <enable_time>  <  disable_timc> 

(applies  only  to  command  line  immediately  following) 
maskinv  <  period>  <  disable_time>  <  enable_time> 

(applies  only  to  command  line  immediately  following) 


nLES 

The  output  file  is  an  ascii  file  and  can  be  inspected  for  programmed  activity  as  a  function  of 
the  time  increments. 

FURTHER  EXPLANATIONS 

The  rules  for  the  input  file  are  discussed  in  more  detail  in  the  following,  in  particular  those 
for  the  more  complex  waveforms. 

Rale  #1:  Comments. 

All  lines  starting  with  a  semicolon  are  considered  comments  and  are  ignored. 

Rule  #2:  Simulation  interval  definition  must  come  first. 

The  first  command  in  the  xtim  file  must  be  the  specification  of  the  simulation  interval;  syntax 
and  example: 

time_range  <start_time>  <stop_time> 
timejange  0  SO 

Note:  Every  value  of  time  is  in  number  of  simulation  step  increments  ’incr’.  The  global 
variable  'incr'  is  assigned  a  value  with  (setq  incr  <  number> )  where  the  number  is 
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the  size  of  the  simulation  step  in  0.1  ns;  this  is  done  in  the  ('.r)  RNL  control  file. 

Rale  #3:  The  report  definition  must  come  last. 

The  last  command  in  the  3tim  file  must  be  the  specification  of  how  often  RNL  should  print  a 
report  (using  the  def-report  specification);  syntax  and  examples: 

report  <  period >  <timel>  <time2>  _ 

report  2  1  (report  every  2  simulation  steps  at  the  end  of  interval  1;  which 

occur  at  t=2.  4.  6,  etc.) 

report  10  3  6  9  (report  every  10  simulation  steps  at  the  end  of  intervals  3,6  and  9: 
t=4,  t=7,  t=10,  t=14,  t=17,  t=20  etc) 

report  1  0  (report  at  the  end  of  every  simulation  step) 

Role  #4:  How  input  signals  are  specified. 

Signals  are  defined  in  one  of  the  following  ways: 

nodename  (states  must  be  1.  h,  u  or  x) 

invec  vectomame  (states  must  be  a  numerical  type: 

decimal,  octal  (leading  *0*), 
hexadecimal  (Ox....)  or  binary  (Ob...)) 

bitinvec  vectomame  (states  can  be  any  combination  of  l,0,u  and  x;  no  spaces  between  the 
elements) 

followed  by: 

the  period,  and  a  number  of  combinations: 

<state>  <time> 

If  the  period  is  "(f  the  specification  relates  to  a  one  time  event  (the  period  is  really  infinity!). 

Syntax  and  example  for  a  simple  waveform  definition  for  simple  node: 

node_name  <  period >  <statel>  <timel>  <state2>  <time2>  . 

node*aamel  10h0i2uSx8 

period  is  10  simulation  steps,  signal  h  at  t=0, 1  at  t=2,  u  at  t=S  and  x  at  t=8; 
signalchanges  repeat  themselves  at  t=10, 12, 15, 18,  20,  22,  etc.. 

Syntax  and  examples  for  a  numerical  vector  definition  (no  undefined  states  can  be  specified  in 
this  case!): 

invec  vectomame  <  period >  <statel>  <timel>  _ _ 

invec  name  10  Oxa  0  Obllll  2  07  5  3  8 

period  is  10  simulation  steps,  vector  is  the  hexadecimal  *a*  at  t=0,  binary  1111  at  t=2, 
octal  *7*  at  t=5  and  a  decimal  '3*  at  t=8.  Again,  the  pattern  is  repeated  10  simulation 
steps  later. 

invec  name  0  Oxa  0  15  5  017  9 

The  pattern  is  a  single  event:  name  is  hexadecimal  "a'  at  t=0,  a  decimal  '15'  at  t=5;  an 
octal  '17'  at  t=9.  This  pattern  does  not  repeat  itself! 

Syntax  and  examples  for  a  bitvector  definition: 

bitinvec  <  vector_name>  <period>  <5tatel>  _ 

bitinvec  vectomame  20  0000  0  1111  5  uuuu  10  xxxx  15 
bitinvec  vectomame  10  Oxlx  0  uOOx  5 
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Role  #5:  Use  of  regular  RNL  commands  allowed  only  with  standard  lisp  syntax. 

RNL  commands  can  also  be  inserted  in  the  same  manner  as  node  and  vector  stimulus;  only 
the  standard  ml  syntax  (with  parentheses  is  allowed): 
syntax: 

command  <  period>  <  (ml_commandl)>  <  timel>  _ 

Role  #<:  Masking  of  input  signals  and  commands. 

Except  for  the  time_range  command  ALL  gen_time  commands  are  subject  to  mask  commands, 
with  will  blank  out  the  impact  of  the  next  command  line  immediately  following  the  mask  com¬ 
mand  line.  After  processing  this  next  command  line  the  mask  is  reset  to  a  default  which  is  a 
full  enable.  There  are  two  mask  commands: 

'mask*  and  ’maskinv* 

’mask*  and  ’maskinv’  themselves  are  defined  as  having  a  period  (a  one  time  mask  has  a  period 
of  ’O’)  and  only  1  enable  and  only  1  disable  time. 

syntax: 

mask  <period>  <  enable_time>  <  disable_time> 
maskinv  <  period>  <  disable_time>  <  enable_time> 

Example: 
mask  0  10  20 
node2  5h01Sul0xlS 

will  blank  out  any  activity  from  node2  before 
time  increment  10  and  after  time  increment  20. 
maskinv  0  10  20 
nodes  S  h  0  1  S  u  10  x  IS 

will  allow  only  nodeS  statements  to  be 
effective  before  time  increment  10  and 
after  time  increment  20. 

The  commands  scheduled  for  the  time  coinciding  with  the  enable  time  of  the  mask  will  be 
effective,  while  the  commands  schedule  for  the  time  coinciding  with  the  disable  time  will  be 
disregarded. 

Example  of  a  typical  stimulus  file: 

;  Timing  file  for  basic  CRC  Counter 

;  Simulation  time: 

time_range  0  36 

;  Run  the  clock  at  all  times: 

cl  2  1  0  h  1 

;  Reset: 

rOhOl  1 

;  The  following  sequence  is  designed  to  exercise  all  nodes! 
in  0 1  0  h  2 1 12  h  20  1  26  h  28  I  32  h  34 
;  We  will  start  reporting  the  unchanged  nodes  just  before 
;  the  last  ff  changes  state,  which  is  at  time  increment  32: 
mask  0  32  36 

command  1  (printf  'nodes  unch:%^n*  (unchanged-since  100))  0 
;  We  report  the  state  after  every  simulation  step: 
report  1 0 
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USING  FATTERNS  DEFINED  USING  GEN.TIMB. 

The  output  file  from  gea_time  with  the  shell  command: 
gen_time  basenameatim  baseaameiime 

Within  the  regular  RNL  control  file  (basenamei)  one  should  include: 
(load  'basename-time*) 


AUTHOR 

Henriecus  Koeman,  John  Fluke  Mfg.  Co.,  Inc. 


DIAGNOSICS 

In  case  of  an  error  in  the  inputfile  genjime  will  most  likely  print  the  first  line  number  and 
the  line  itself  where  the  error  was  detected  and  then  terminate  prematurely. 


BUGS 

Please  let  the  author  know. 
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NAME 

lyra  -  Performs  hierarchieal  layout  rule  check  on  caesar  design. 

SYNOPSIS 

lyra  [-vi]  [-o  output]  [-p  path]  [-r  ruleset]  [-t  technology]  rootCaesarFile, 
or 

lyra  -a  [-t  technology]  [-r  ruleset] 

DESCRIPTION 

Lyra  has  two  modes  of  operation:  it  can  be  invoked  directly  to  perform  a  batch  hierarchical 
check  of  a  caesar  design,  or  from  the  Caesar  (or  Kie)  layout  editor  to  interactively  check  a 
portion  of  the  design  currently  being  edited. 

In  batch  mode,  a  hierarchical  check  of  the  caesar  design  rooted  at  rootCaesarFile  is  done.  A 
log,  including  a  summary  of  errors  is  written  to  stdout,  and  a  lyra  file  'nameJy*  is  created  for 
every  cell  *namejca*  in  which  design  rule  violations  are  detected.  The  lyra  61es  flag  each 
design  rule  violation  with  a  bright  splotch  of  paint  on  the  error  layer,  and  a  caesar  label  iden¬ 
tifying  the  type  of  violation.  The  lyra  file  for  a  cell  'namexa'  contains  the  original  caesar  file 
as  a  subcell,  thus  the  caesar  subedit  command  can  be  used  to  conveniently  fix  design  rule  vio¬ 
lations  reported  by  Lyra.  Obsolete  lyra  files  are  removed  by  Lyra  when  a  cell  checks  on  the 
current  run. 

Lyra’s  violation  messages  have  the  form: 

!<  LayersOrConstructs  >  _<  Type  > . 

Note  that  all  violation  messages  begin  with  an  exclamation  mark  (*r).  LayersOrConstructs 
gives  the  single  character  abbreviations  for  the  layers  involved  in  the  violation.  Circuit  con¬ 
structs  such  as  transistors  and  buried  contacts  may  also  be  indicated  by  short  abbreviations 
(eg.  tr  for  transistor;  Be  for  buried  contact).  Type  is  given  by  one  or  two  characters  indicating 
the  type  of  error  as  follows: 

s  -  minimum  spacing  violation, 

w  s  minimum  width  violation, 

pc  *  parallel  edge  spacing  violation, 

x  »  insufficient  extension  or  enclosure, 

p  =  polarity,  eg.  Dif.  doping  doesn’t  match  well  in  CMOS, 

f  >  malformed  circuit  construct. 

For  example,  a  q>acing  violation  between  Polysilicon  and  Diffusion  would  look  like  this: 

!F/D_S. 

Note  that  Parallel  Edge  checks  are  leas  restrictive  than  the  correqionding  Width  and  Spacing 
checks  would  be,  since  they  ignore  diagonal  interactions. 

The  following  rulesets  are  currently  soppoited  at  Berkeley: 

nassBERK 

Berkeley  nMOS  mice.  Modified  Mead  St  Conway  rules.  Buried  contacts  are  supported; 
Butting  Contacts  are  disallowed.  The  Lyon  Implant  rules  are  used. 

cmes-pwJPL 

CMOS  rales  (p  well).  An  extension  of  the  Mead  and  Conway  nMOS  rules  to  CMOS, 
worked  out  by  Carlo  Sequin  in  conjunction  with  JPL. 
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booiMC 

Mctd  A  Conway  nMOS  mlco  as  described  in  'Introduction  to  VLSI  Systems*  by  Mead 
and  Conway.  Butting  Contacts  are  allowed;  buried  contaets  are  not  allowed. 

cmoo>pw3 

MOSIS  3  micron  bnik  enmo  proccoa,  (see  below  for  details).  This  is  the  default  ruleset 
for  technology  cmos-pw. 

cmoo-Mlvl 

MOSIS  3  micron  bulk  cmoo  proccoo,  (see  below  for  details). 

laocmoo 

GTE  5  micron  laocmoo  procem. 

If  the  -r  option  is  not  given,  Lyra  chooses  a  ruleset  based  on  the  teehaology  specified  in  the 
rootCaesarFile.  The  correspondence  between  caesar  teeknolopes  and  default  rulesets  is 
specified  in  ~ cadllibIlyralDEF AULTS.  If  Lyra  doe*  not  recognize  the  technology  of  the 
rootCaesarFile,  it  uses  the  default  ruleset  for  nmos. 

In  editor  mode  standard  input  and  standard  output  are  used  to  communicate  with  the  layout 
editor,  no  log  is  written  to  stdout!,  and  violations  are  flagged  directly  in  the  edit  cell.  The 
caesar  technology  or  ruleset,  if  different  from  nmos,  must  be  speeified  ezpdcitly  on  the  com¬ 
mand  line,  since  Lyra  does  not  have  direct  access  to  the  caesar  database.  Note  that  interactive 
checks  are  nonhierarchical  and  slow,  thus  it  is  a  good  idea  to  use  this  mode  only  to  check 
small  pieces  of  a  design;  complete  designs  are  best  checked  in  batch  mode. 

The  options  described  below  may  be  specified  in  a  xadre  file  or  as  command  line  options. 
Lyra  reads  options  from  ‘cad! xadre,  'txadre  and  the  command  line,  in  that  order.  If  an 
option  is  specified  in  more  than  one  place,  the  later  setting  takes  precedence.  Capitalizing  an 
option  on  the  command  line,  or  giving  the  keyword  nnacK  option>  in  xadre  causes  the 
option  to  be  reset  to  its  default  value  (e^.  *Iyra  -R',  resets  any  previous  ruleset  specification, 
forcing  the  default  to  be  used). 

-c  (edit  mode)  Used  by  Caesar  and  Kle.  In  this  mode  Lyra  reads  rectangles  etc.  from  stan¬ 
dard  input  and  reports  violations  on  standard  output. 

-o  <  ootpotDtr> 

(output  directory)  Gives  directory  for  l)rra  (-Jy)  files.  Defaults  to  current  directory. 

-p  <  path> 

(search  path  for  caemr  files)  Path  gives  a  colon  (’f)  separated  sequence  of  directorys 
to  be  searched  in  order  for  caesar  files.  The  default  search  path  is  just  the  current 
directory.  As  in  caesar  ~cad/lib/eaesar  is  searched  as  a  last  resort. 

-r  <  mlcoeO 

(design  rule  set)  Gives  ruleset  to  use.  Rulesets  are  stored  in  ‘cadllibilyra.  A  user  can 
supply  his  own  ruleset  by  giving  the  full  pathname  on  the  -r  option  (see  rulcc).  If  the 
-r  option  is  not  specified,  Lyra  determines  which  ruleset  to  use  from  the  technology 
specified  in  the  rootCaesarFile  for  the  design. 

-t  <  tcchBology> 

(caesar  technology)  Used  to  specify  caesar  technology  in  editor  mode,  or  to  override  the 
technology  given  in  the  rootCaesarFile.  Lyra  uses  the  caesar  technology  to  choose  a 
default  ruleset. 

-V  (verbom  mode)  Causes  more  detailed  log  information  to  be  written  to  stdout.  This 
option  is  primarily  for  debugging. 

-a  (restart)  If  Lyra  dies  abnormally,  it  leaves  a  RESTART  file  in  the  output  directory 
which  gives  the  cells  which  were  completely  checked.  Lyra  can  then  be  restarted  with 
the  -a  option,  to  resume  checking  with  the  first  (sub)cell  not  already  checked.  Note 
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that  the  mtait  option  should  only  be  used  if  the  caesar  database  for  the  project  has 
not  been  changed  since  the  time  the  original  Lyra  run  was  started. 

DIAGNOCTICS 

CMOS-PW3  MOSIS  3  MICRON  CMOS  DESIGN  RULES.  VUO 

'C  sT  contact-contact  separation:  3u 

*C  w*  contact  width:  3u 

*C2  r  metal2  extension  around  via:  2  Ju 
metal  extension  around  via:  2Sa 
*C2  s*  via-via  separation:  3u 

'C2  w'  via  width:  3u 

'C/C2  s*  via-cut  separation:  3u 

'D  s*  active  area-active  area  separation:  4u 

'D  w*  active  area  width:  4u 

"Dn-f  w*  N4-  active  area  width:  4u 

'Dp-t-  w'  P-l-  active  area  width:  4u 

*Dw  w*  P-f  active  area  (not  gate)  width:  3u 

N4-  active  area  (not  gate)  width:  3u 
*D/C2  s*  if  active  area  ia  not  under  via,  via-active  area 
separation:  3a 

*D/C2  X*  if  active  area  is  under  a  via,  active  area  extension 
around  via:  3u 

'D/p+ S*  N-t- active  area  to  P+ q>acing:2u 

*M  s*  metai-metal  separation:  4u 

'M  w*  metal  width:  3u 

*MP/PMM2  X*  step  missing  for  metal2  step  coverage 
*M2  sT  metaI2-metal2  separation:  5o 

*M2  w'  mctal2  width:  Su 
*M2/P  St*  met8i2/metal/poly  width:  lu 

*M/PMM2  x*  metal  step  width  for  metai2: 4u 
'M/P/M2  St*  poly-metal  separation  when  under  metal2  with  no 
overlap:  Su 

*P  s*  poIy-poIy  separation:  3u 

*PMC  X*  extra  5  micron  in  direction  of  metal  in  poly-metal 
contacts 

*Pw  w*  poly  (not  gate)  width:  3u 

*P/C2  s*  if  poly  is  not  under  via,  via-poly  separation:  3u 

*P/C2  X*  if  poly  is  under  a  via,  poly  extension:  3u 

*P/D  s^  poly-active  area  separation:  2u 

*P/M/M2  St*  poly-metal  separation  when  under  metal2  with  no 
overlap:  Su 

*P/PMM2  X*  poly  step  width  for  metaI2: 3u 
*T  w*  Gate  area  width:  3u 
*T/C  s*  contact  to  gate  separation:  3u 
*T/n4-  s*  P-t-  extension  around  gate  outside  p-well:  33u 
*T/p-»-  s*  gate  inside  p-well  to  P-t-  (of  ohmic  contact) 
separation:  33u 

*VIA  r  via  has  obtuse  comer 
*Wp  a*  p-well  to  p-well  separation:  9tt 
*Wp  w*  p-well  width:  3u 

*Wp/n+Wn  s*  N+  active  area  (ohmic  contact)  to  p-well 
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separation:  7u 

*c  r  metal  and  (poly  or  active  area)  required  under  cuts 

metal  extension  around  cut:  2u 
active  area  extension  around  cut:  2u 
poly  extension  around  cut:  2u 
'pW/n+D  X*  p-well  extension  around  active  area:  4u 
'pW/p-fD  s'  separation  of  p-well  from  P-t-  active  area:  8u 
'p-f-  s*  p-(-  to  p-l-  separation:  3u 
'p-f/D  'C  P+  extension  around  P-f  active  area:  2u 
'sc  V  split  ohmic  contact  must  be  4  microns  into  P-t-  active 
area  and  4  microns  into  N-t-  active  area 
'tr  r  malformed  poly  or  active  area  abuttment:  3u  extension 
'tr  p'  polarity:  P-f  implanted  transistor  in  p-well 

polarity:  N-f  implanted  transstor  outside  p-well 


CMOS-PW3  MOSIS  3  MICRON  CMOS  DESIGN  RULES,  V1.1 
Same  as  ID  with  the  following  exceptions: 
modified  rules: 

'C2  r  metal2  extension  around  via:  2u 
metal  extension  around  via:  2a 
'M2/P  St'  metal2/metal/poly  width:  3u 
'M/PMM2  s'  metal  step  width  for  metal2: 3u 
'M/P/M2  St'  poly-metal  separation  when  under  metal2  with  no 
overlap:  3u 

*P/C2  sT  if  poly  is  not  under  via,  via-poly  separation:  4u 

'P/C2  X*  if  poly  is  under  a  via,  poly  extension:  4u 

'P/M/M2  St'  poly-metal  separation  when  under  metal2  with  no 
overlap:  3u 

'P/PMM2  s'  poly  step  width  for  metal2: 3u 
new  rule: 

'D  W'  Active  Area  transistor  abuttment  width:  4u 


nLES 

'cad/bin/lyra  --  executable  lyra. 

'cad/lib/Iyra  -  rulesets  (in  symbolic  and  executable  form). 
'cad/lib/lyra/DEFAULTS  --  gives  default  rulesets  for  caesar  technologies. 

SEE  ALSO 

Rulec  (CAD) 

Caesar  (CAD) 

KIC  (CAD) 

Cif2ca  (CAD) 

Cifplot  (CAD) 

AUTHOR 

Michael  Arnold. 
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NAME 

mexnodes  -  integrate  intermediate  nodes  extracted  by  mextra  with  the  original  caesar  design. 
SYNOPSIS 

mexnodes  [options]  basename 
DESCRIPTION 

Mexnodes  is  a  shell  script  that  uses  eif2ca  and  caesar  to  generate  a  Caesar-format  file.  This  file 
allows  the  user  to  view  the  intermediate  nodes  named  by  mextra  on  the  original  design.  Mex¬ 
nodes  can  be  helpful  when  a  simulation  tool  reports  etrots  at  a  node  not  named  by  the  user,  as 
such  errors  are  sometimes  hard  to  locate.  Tlie  output  file  created  by  mexnodes  is  named 
aubasenamexa.  This  file  can  be  then  viewed  using  caesar  in  order  to  find  a  given  node. 

The  options  are  as  follows: 

-t  technology 

Technology  is  one  of  nmos,  isoemos,  or  emos-pw.  Default  is  nmos. 

-I  lambda 

Lambda  specifies  the  centimicrons  to  lambda  correspondence  of  the  design.  Default  is 
200  centimicrons  per  lambda. 

FILES 

basename  M 
mxbasenamexa. 
basename  stodt% 
basename  jcif 

SEE  ALSO 

caesar(CADl),  cif2ca(CADl),  mextra(CADl) 

AUTHOR 

Terry  J.  Ligocki 

BUGS 
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NAME 

mextra  -  Manhattan  circuit  extractor  for  VLSI  simulation 
SYNOPSIS 

mextra  [-g]  [-a  scale]  [-«]  basenama 
DESCRIPTION 

Mextra  will  read  the  file  baseiiamexit  and  create  a  circuit  description.  From  this  circuit 
description  various  electrical  checks  can  be  done  on  your  circuit.  The  circuit  description  is 
directly  compatible  with  esim,  powest,  and  ere.  There  are  translation  programs  to  convert  mex¬ 
tra  output  to  acceptable  spice  input  (see  simZspice,  pspice  and  spcpp  ). 

Mextra  creates  four  new  files,  basetumeJUsgt  basenamejolt  basenameMm  and  hasenamejiodcs. 
After  mextra  finishes  it  is  a  good  idea  to  read  the  Jog  file.  This  contains  general  information 
about  the  extraction.  It  has  a  count  of  the  number  of  transistors  and  the  number  of  nodes, 
and  it  contains  messages  about  possible  errors.  The  al  file  is  a  list  of  aliases  which  can  be  used 
by  esim.  The  modes  file  is  a  list  of  node  names  and  their  GIF  locations  listed  in  GIF  format.  It 
can  be  read  by  eifplot  to  make  a  plot  showing  the  circuit  with  the  named  nodes  superimposed. 
The  form  of  this  eifplot  command  is: 

clfplot  basename  JsaAea  basenamexXt 

The  Jim  file  is  the  circuit  description  for  use  with  simulation  programs  and  electrical  rule 
checkers.  The  format  of  the  .sIm  file  is  described  in  the  man  page  slmflle(S). 

Namm 

Mextra  uses  the  GIF  label  construct  to  implement  node  names  and  attributes.  The  form  of  the 
GIF  label  command  is  as  follows: 

94  name  x  y  \layer\. 

This  command  attaches  the  label  to  the  mask  geometry  on  the  specified  layer  crossing  the 
point  (x,  y).  If  no  layer  is  present  then  any  geometry  crossing  the  point  is  given  the  label. 

Mextra  interprets  these  labels  as  node  names.  These  names  are  used  to  describe  the  extracted 
circuit.  When  no  name  is  given  to  a  node,  a  number  is  assigned  to  the  node.  A  label  may 
contain  any  ASGII  character  except  space,  tab,  newline,  double  quote,  comma,  semi-colon, 
and  parenthesis.  To  avoid  confiict  with  extractor  generated  names,  names  should  not  be 
numbers  or  end  in  ’#«’  where  n  is  a  number. 

A  problem  arises  when  two  nodes  are  given  the  same  name  although  they  are  not  connected 
electrically.  Sometimes  we  want  these  nodes  to  have  the  same  names,  other  times  we  don’t. 
This  frequently  happens  when  a  name  is  specified  in  a  cell  which  is  repeated  many  times.  For 
instance,  if  we  define  a  shift  register  cell  with  the  input  marked  ’SR.in*  then  when  we  create 
an  8  bit  shift  register  we  could  have  8  nodes  names  ’SRin’.  If  this  happens  it  would  appear  as 
though  all  8  of  the  shift  register  cells  were  shorted  together.  To  resolve  this  the  extractor 
recognizes  three  different  types  of  names:  local,  global,  and  unspecified.  Any  time  a  local 
name  appeara  on  more  than  one  node  it  is  appended  with  a  unique  suffix  of  the  form  ’#n’ 
where  n  is  a  number.  The  numbers  are  assigned  in  scanline  order  and  starting  at  0.  In  the 
shift  register  example,  the  names  would  be  ’SRin#0’  through  ’SRin#7'.  Global  names  do  not 
have  suffixes  appended  to  them.  Thus  unconnected  nodes  with  global  names  will  appear  con¬ 
nected  after  extraction.  (The  -g  causes  the  extractor  to  append  unique  suffixes  to  uncon¬ 
nected  nodes  with  the  same  global  name.)  Names  are  made  local  by  ending  them  with  a  sharp 
sign,  Names  are  global  if  they  end  with  an  exclamation  mark,  T.  These  terminating  char¬ 
acters  are  not  considered  part  of  the  name,  however.  Names  which  do  not  end  with  these 
charactets  are  considered  unspecified.  Unspecified  names  are  treated  similar  to  locals.  Multi¬ 
ple  occurrences  are  appended  with  unique  suffixes.  By  convention,  unq>ecified  names  signify 
the  designer’s  intention  that  this  name  is  a  local  name,  but  is  connected  to  only  one  node.  It 
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is  illegal  to  have  a  name  that  is  declared  two  different  types.  The  extractor  will  complain  if 
this  is  so  and  make  the  name  local. 

It  makes  no  difference  to  the  extractor  if  the  same  name  is  attached  to  the  same  node  several 
times.  However,  if  more  than  one  name  is  given  to  a  node  then  the  extractor  must  choose 
which  name  it  will  use.  Whenever  two  names  are  given  to  the  same  node  the  extractor  will 
assign  the  name  with  the  highest  type  priority,  global  being  the  highest,  unspecified  next,  local 
lowest.  If  the  names  are  the  same  type  then  the  extractor  takes  the  shortest  name.  At  the 
end  of  the  Jog  file  the  extractor  lists  nodes  with  more  than  one  name  attached.  These  lines 
start  with  an  equal  sign  and  are  readable  by  esim  so  that  it  will  understand  these  aliases. 


Attributes 

In  addition  to  naming  nodes  mextra  allows  you  to  attach  attributes  to  nodes.  There  are  two 
types  of  attributes,  node  attributes,  and  transistor  attributes.  A  node  attribute  is  attached  to  a 
n^e  using  the  GIF  94  construct,  in  the  same  way  that  a  node  name  is  attached.  The  node 
attribute  must  end  in  an  at-sign,  ’®\  More  than  one  attribute  may  be  attached  to  a  node. 
Mextra  does  not  interpret  these  attributes  other  than  to  eliminate  duplicates.  For  each  attri¬ 
bute  attached  to  a  node  there  appears  a  line  in  the  .aim  file  in  the  following  form: 

A  node  attribute 

Node  is  the  node  name,  and  attribute  is  the  attribute  attached  to  that  node  with  the  at-sign 
removed. 

Transistor  attributes  can  be  attached  to  the  gate,  source,  or  drain  of  a  transistor.  Transistor 
attributes  must  end  in  a  dollar  sign,  *$’.  To  attach  an  attribute  to  a  transistor  gate  the  label 
must  be  placed  inside  the  transistor  gate  region.  To  attach  an  attribute  to  a  source  or  drain  of 
a  transistor  the  label  must  be  placed  on  the  source  or  drain  edge  of  a  transistor.  Transistor 
attributes  are  recorded  in  the  transistor  record  in  the  jIb  file. 

Transistors 

For  each  transistor  found  by  the  exractor  a  line  is  added  to  the  jim  file.  The  form  of  the  line 

is: 

type  gate  source  drain  length  width  x  y 
g=attributes  n=attributes  d=attributes 

Type  can  be  one  of  three  characters,  V  for  enhancement,  ’d’  for  depletion,  or  ’u’  for  unusual 
implant.  (  Unusual  implant  refers  to  transistors  which  are  only  partially  in  an  implanted  area. 
It  will  be  necessary  to  write  a  filter  to  replace  these  transistors  with  the  appropriate  model  in 
terms  of  enhacement  and  depletion  transistors.)  Cate,  source,  and  drain  are  the  gate,  source, 
and  drain  nodes  of  the  transistors.  Length  and  width  are  the  channel  length  and  width  in  GIF 
units.  X  and  y  are  the  x  and  y  coordinates  of  the  bottom  left  comer  of  the  transistor.  Attri¬ 
butes  is  a  comma  seperated  list  of  attributes.  If  no  attribute  is  present  for  the  gate,  source,  or 
drain,  the  g»,  •=,  or  6=  fields  may  be  omitted. 

The  extractor  guesses  the  length  and  width  of  a  transistor  by  knowing  the  area,  perimeter, 
and  length  of  diffusion  terminals.  For  rectangular  transistors  and  butting  transistors  the 
reported  length  and  width  is  accurate.  For  transistors  with  comers  or  for  unusually  shaped 
transistors  the  length  and  width  is  not  as  accurate. 

It  is  possible  to  design  a  transistor  with  three  or  more  diffusion  terminals.  The  extractor  con¬ 
siders  these  u funny  transistors.  They  are  entered  in  the  .sfau  file  in  the  form: 

ftype  gate  nodel  node2  ...  nodeN  xloc 
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The  T  is  followed  by  the  type  :  ’e',  ’4*  or  ’n*.  Nodel ...  nodeN  are  the  diffusion  terminal  nodes. 
As  with  any  circuit  with  ’a’  transistors,  any  circuit  with  ’V  transistors  must  be  run  through  a 
filter  replacing  each  of  the  funny  transistors  with  the  appropriate  model  in  terms  of  enhance¬ 
ment  and  depletion  transistors. 

Capaeltancc 

The  .aim  file  also  has  information  about  capacitance  in  the  circuit.  The  lines  containing  capa¬ 
citance  information  are  of  the  form: 

C  nodel  node2  cap-vaiue 

cap-value  is  the  capacitance  betweens  a  node  and  substrate  is  in  femto-farads.  Capacitance 
values  below  a  certain  threshold  are  not  reported.  The  default  threshold  is  SO  femto-farads. 

Transistor  capacitances  are  not  included  since  most  of  the  tools  that  work  on  the  jim  file  cal¬ 
culate  them  from  the  width  and  length  information. 

The  capacitance  for  each  layer  is  calculated  separately.  The  reported  node  capacitance  is  the 
total  of  the  layer  capacitances  of  the  node.  The  layer  capacitance  is  calculated  by  taking  the 
area  of  a  node  on  that  layer  and  multiplying  it  by  a  constant.  This  is  added  to  the  product  of 
the  perimeter  and  a  constant.  The  default  constants  are  given  below.  Area  constants  are  in 
femto-farads  per  square  micron.  Perimeter  constants  are  femto-farads  per  micron. 


Layer 

Area 

Pe 

metal 

0.03 

OD 

metal2 

ODIS 

OD 

poly 

OjOS 

OjO 

diff(n) 

0.10 

0.1 

diff(p) 

0.10 

0.1 

poly/difr 

0.40 

OjO 

Poly/diffusion  capacitance  is  calculated  similar  to  layer  capacitance.  The  area  is  multiplied  by 
constant  and  this  is  added  to  the  perimeter  multiplied  by  a  constant.  Poly/diffusion  capaci¬ 
tance  is  not  threshold,  however. 

The  -«  option  supresses  the  calculation  of  capacitance,  and  instead,  gives  for  each  node  in  the 
circuit  the  area  and  perimeter  of  that  node  on  the  diffusion,  poly,  and  metal  layers.  The  lines 
containing  this  information  look  like  this: 

L  node  metaI2Area  metal2Perim  metalArea  metalPerim  polyArea  polyPerim  diffArea  diffPerim 
diffpArea  diffpPerim 

Node  is  the  node  name,  x  y  is  the  position  of  a  point  on  the  node.  Currently  this  is  always  *0 
O’.  metal2Area  through  diffpPerim  are  the  area  and  perimeter  of  the  metaI2,  metal,  poly, 
diffusion(n),  and  diffusion(p)  layers  in  user  defined  units.  (In  addition  the  -o  option  causes 
transistors  with  only  one  terminal  to  be  recorded  in  the  jlm  file  as  a  transistor  with  source 
connected  to  drain.) 

//  the  network  is  being  extracted  from  the  eif  file  we  suggest  the  node  capacitance  not  be  com¬ 
puted  by  mextra.  Rather  the-o  option  should  be  used.  This  puts  the  burden  of  computing  node 
capcitance  on  the  programs  presim  and  sim2spice2.  We  feel  this  is  advantageous  because 
presim  and  sim2spice2  are  filter  programs  linked  directly  to  the  type  of  simulation  that  is  to  be 
done.  This  will  hopefully  reduce  some  of  the  confusion  associated  with  calibration. 

Changing  Default  Values 

As  part  of  its  start  up  procedure  mextra  reads  two  files:  /usr/vlsibin/xadrc  and  then  a  search 
for  the  first  .cadre  from  the  current  directory  (.)  to  the  the  user’s  home  directory  is  made. 
Mextra  reads  these  files  to  set  up  constants  to  be  changed  without  recompiling.  The  keywords 
for  mextra  are  contained  within  the  mextra  environment  of  the  xadre  file.  Declaration  of 
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environments  in  the  ^drc  file  are  described  in  £adrc(S). 

By  default,  mextra  reports  locations  in  CIF  coordinates.  A  more  convenient  form  of  units  may 
be  specified  either  in  the  .endre  file  or  on  the  command  line.  The  form  of  the  line  in  the 
xadre  file  is: 

units  scale 

where  scale  is  in  centi-microns.  The  user  may  type  in  the  chosen  value  for  the  scale  directly. 
To  set  units  on  the  command  line  use  the  -o  option, 
meztrn  -n  scale  basename 

The  parameters  used  to  compute  node  capacitance  may  be  changed  by  including  the  following 
commands  in  your  xadrc  file. 

amtoenp  loj^er  value 
pcrimctertocap  layer  value 

value  is  atto-farads  per  square  micron  for  area,  and  atto-farads  per  micron  for  perimeter. 
layer  may  be  "poly*,  'diff*,  'metal*,  *metal2r,  or  'poly/diff*. 

To  set  the  capacitor  values  to  those  given  in  Mead  and  Conway  the  following  lines  would 
appear  in  the  xadrc  file: 
areatocap  poly  40 
areatocap  diff  100 
areatocap  metal  30 
areatocap  poly/diff  400 
perimetertocap  poly  0 
perimetertocap  diff  0 
perimetertocap  diff  0 
perimetertocap  metal  0 
perimetertocap  poly/diff  0 

The  threshold  for  reporting  capacitance  may  be  set  in  the  xadrc  file  with  the  following  line, 
capthrcshold  value 

A  negative  value  sets  the  threshold  to  infinity. 

Mextra  knows  of  two  technologies,  nMOS  and  cMOS  p-well.  NMOS  is  assumed  by  default. 
To  set  the  technology  to  cMOS  p-well,  include  the  following  line  in  your  xadrc  file: 

tech  cmos-pw 

HLES 

'/.cadre 

basenamejat 

basename.al 

basenameAog 

basename. nodca 

basenamejnm 

SEE  ALSO 

powest(l.vlsi),  pspice(l.vlsi),  spcpp(l.vlsi),  sim2spice(l.vlsi),  spice(l.vlsi),  drc(l.vlsi),  erc(l.vlsi) 
caesar(cadl), 

cadrc(cad5),  simfile(l.vlsi). 

AUTHOR 

Dan  Fitzpatrick  (UCB) 
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MODIFICATIONS 

(UW/NW  VLSI  Consortium,  University  of  Washington) 

BUGS 

Accepts  manhattan  simple  CIF  only,  use  elf  plot  -O  to  convert  complicated  CIF.  For  unusu¬ 
ally  shaped  transistors  the  UW/NW  modified  mextra  should  be  used,  otherwise  values  will  be 
quite  inaccurate.  The  modified  mextra  will  either  yield  accurate  values  or  a  "reasonable”  guess, 
depending  on  the  complexity  of  the  unusual  transistor.  The  modified  mextra  will  tell  you 
when  the  output  values  are  only  best  estimates.  The  length/width  ratio  for  unusually  shaped 
transistors  may  be  inaccurate.  This  is  true  for  snake  transistors.  Attributes  for  funny  transis¬ 
tors  are  not  recorded.  Node  attributes  are  ignored  unless  the  -o  switch  is  present. 
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NAME 

Ditp  -  Multiple  Time-series  Plot  for  simulator  output 
SYNOPSIS 

mtp  behavior-file  directive-file  plot-file 
DESCRIPTION 

Mtp  plots  the  output  of  rnl  and  spice  simulations  on  the  Printronix  line  printer.  Behavior-file 
is  the  rnl  or  spice  output  file,  directive-file  is  a  'specification  file*  for  the  plot,  and  plot-file  is 
an  output  file  to  contain  the  plot  suitable  for  printing  on  the  Printronix  line  printer. 

The  use  of  mtp  involves  the  following  steps: 

1.  Generate  a  behavior  file. 

If  you  are  using  rnl,  the  directive 
openplot  "behavior -fil^ 

will  cause  the  changes  to  all  traced  nodes  to  be  written  to  behavior-file  in  addition  to 
being  written  to  the  terminal.  Quotes  are  necessary  if  the  file  name  has  any  punctua¬ 
tion  in  it. 

The  RNL  directive 
closeplot 

will  terminate  the  behavior  file.  If  the  entire  rnl  session  is  to  be  recorded  closeplot  is 
not  required,  as  the  file  will  be  terminated  when  rnl  exits. 

If  you  are  using  spice,  a  behavior  file  may  be  specified  as  the  third  positional  parame¬ 
ter  of  the  spice  command.  Behavior  records  will  be  put  on  this  file  for  all  nodes 
specified  on  the  Spice  fiLOT  directive. 

2.  Generate  a  plot  file  from  the  behavior  file  using  mtp. 

The  plot  is  sent  to  the  Printronix  printer  using  the  Unix  command 
Ipr  -1  plot -file 

The  contents  of  behavior-file  arc  interpreted  with  the  help  of  directive-file.  For  the  basic  pur¬ 
pose  of  plotting  tbe  output  of  rnl  or  spice,  only  a  few  directives  need  be  supplied: 

1.  start  time 

Tells  mtp  when  to  start  plotting.  If  not  supplied  time  defaults  to  0.  Data  is  skipped  on 
the  behavior  file  until  an  event  is  found  whose  time  is  greater  than  or  equal  to  the 
start  time. 

2.  stop  time 

Tells  mtp  when  to  stop  plotting.  A  stop  value  must  be  specified.  If  the  stop  time  is 
greater  than  the  time  of  the  last  event  on  the  behavior  file,  the  plot  will  be  concluded 
with  the  last  event. 

3.  scale  time 

Tells  mtp  the  number  of  time  units  per  inch.  The  default  value  is  1000.0.  Because  the 
time  unit  used  by  rnl  for  behavior  file  output  is  1.0  nanosecond,  this  value  will  pro¬ 
duce  plots  of  rnl  output  having  a  scale  of  ID  microsecond  per  inch. 

4.  logical  signal 

This  is  used  primarily  for  plotting  rnl  output.  To  select  signals  A,  B  and  C  for  plot¬ 
ting  in  logical  format  the  directives  would  be 

logical  A 
logical  B 
logical  C 
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5.  uulog  signal  height 

Analog  format  is  required  when  dealing  with  spice  output  because  spice  produces 
floating  point  values  rather  than  logic  levels.  The  height  in  inches  of  each  trace  must 
be  specified.  To  select  node  voltages  for  nodes  1,  2  and  3  for  plotting  in  analog  format 
the  necesary  directives  might  be 

analog  V(l)  05 
analog  V(2)  OJ 
analog  V(3)  OJ 

The  order  of  selection  directives  in  the  file  determines  the  order  of  the  traces  on  the  plot. 
The  first  signal  selected  is  plotted  closest  to  the  time  axis.  A  maximum  of  20  signals  may  be 
selected  on  a  given  plot. 

Spaces  are  used  to  separate  the  fields  of  a  directive  line.  Blank  lines  or  lines  starting  with  # 
are  ignored.  Directives  are  case  insensitive  except  for  signal  names. 

EXAMPLE 

The  following  example  uses  mtp  to  plot  the  behavior  of  a  10  bit  counter,  cntrlOjiet,  shown 
here  in  netlist  format: 

;  net  file  for  10-bit  counter 

;  half  adder  made  from  gates 
(macro  half_adder  (a  b  s  c) 

(local  hi  h2  h3) 

(nand  (hi  2  16)  a  b) 

(nand  (h2  2  16)  a  hi) 

(nand  ^3  2  16)  b  hi) 

(nand  (s  2  16)  h2  h3) 

(invert  c  hi) 

) 

;  one  cell  of  a  counter 
(macro  cell  (in  out  Cin  Cout) 

(local  cl  c2  c3) 

(invert  cl  in) 

(trans  phil  cl  c2) 

(invert  c3  c2) 

(half_adder  c3  Cin  out  Cout) 

(trans  phi2  out  in) 

) 

;  declare  global  node  names 
(node  count  c  in  out  phil  phi2) 

;  carry-in  to  first  significant  bit  controls  counting  action 
(connect  count  c.0) 

;  generate  the  counter 
(repeat  i  1  10 
(capacitance  out.i  1.234) 

(ceil  in.i  out.i  c.(l-  i)  c  j) 

) 
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The  ml  control  file,  cntrlO.1,  is  as  follows: 

;  RNL  initialization  file  for  10  bit  ripple-carry  counter 

(load  'uwstdJ*) 

(load  'uwsimJ'^ 

(read-network  'cntrlOO 

;  (setq  report-form  nil)  This  turns  off  the  report  generator 

(setq  incr  1000) 

;  bind  symbols  to  node  names 

(chflag  *(phil  phi2  out.lO  out^  outR  out.7  out.6 
out  J  out.4  out3  out2  out.l)) 

(defun  init  (dummy) 

(I  ‘(count  in.l  in2  in3  in.4  in3 
in^  in.7  in3  in.9  in.l0)) 

(1  ‘(phi!)) 

(h  ‘(Phil)) 

(step  incr) 

(I  '(Phil)) 

(step  incr) 

(x  ’(in.l  ia2  in3  in.4  in3 
in.6  in.7  in3  in.9  in.lO)) 

(h  '(phi2)) 

(step  incr) 

(1  '(phi2)) 

(step  incr) 

(h  ’(count)) 

(wr-report) 

’done 

) 


(defvec  ’(bit  bout  out.lO  out.9  outR  out.7  out.6 
out3  out.4  out3  out3  out.l)) 

(defvec  ’(dec  dout  out.lO  out.9  outJB  out.7  out.6 
out3  out.4  out3  out2  out.l)) 
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(def'Fqwrt  ’(*10  bit  counter  current  state'  newline  *  * 
count  (vec  bout)  (vec  dout))) 


Generate  the  behavior  for  the  counter  using  rnl 

netlist  cntrlOjiet  cntrlO^im 
presim  cntrlOjim  cntrlO 
ml  cntrlOi 

init  #  initialize  the  counter 

openplot  'cntrlOxvl*  #  open  the  behavior  file 

#  (xvl  stands  for  event  list) 
c  30  #  run  30  clocks 

exit  #  exit  ml 

Generate  the  plot. 

mtp  cntrlOxvl  cntrl0.mtp  cntrl0.plt 
Ipr  cntrl0.plt 

The  file  cntrlOmtp  could  contain  the  following: 

start  OX) 
stop  20000.0 
scale  lOOOJO 
logical  phil 
logical  phi2 
logical  out.l 
logical  out  .2 
logical  outJ 
logical  out.4 
logical  outJ 

The  start  and  scale  directives  are  not  necessary  but  are  included  for  the  purpose  of  illustra¬ 
tion.  Although  not  required,  these  directives  typically  preceed  the  signal  selection  directives 
in  the  file. 

When  nap  runs  it  lists  the  contents  of  the  directive  file  on  the  terminal  and  reports  progress 
with  the  following  messages: 

Previous  output  cntrl0.plt  removed 
Select  and  preprocess  input  data 
Sort  preprocened  events 
Generate  the  plot 
Rasterize  for  the  Printrontx 
mtp  complete,  plot  file  is  cotrlO.plt 
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The  'Rasterize  for  the  Printronuc*  message  marks  the  beginning  of  the  longest  step  in  the  pro¬ 
cess  which  typically  takes  about  a  minute  under  moderate  system  loads. 

Mtp  creates  scratch  files  named  fort.I,fort2,fortJ,fori.4,  and  fort.7.  If  any  of  these  files  are 
present  when  mtp  is  invoked  it  will  exit  with  an  error  message.  This  can  happen  if  mtp  is 
aborted  before  having  time  to  clean  up  the  scratch  files.  If  this  happens  the  scratch  files  can 
be  cleaned  up  with  the  Unix  command 

rm  fort  .[12347] 

SEE  ALSO 

ml(l.vlsi)  spice(l.vlsi). 

User's  Guide  to  RNL  VLSI  Design  Tools  Reference  Manual,  UW/NW  VLSI  Consortium, 
University  of  Washington,  (Christopher  Terman,  MIT  Laboratory  for  Computer  Science). 

SPICE  User's  Guide.  VLSI  Design  Tools  Reference  Manual,  UW/NW  VLSI  Consortium, 
University  of  Washington,  (A.  Vladimirescu  et  al.,  IS  Oct.  1980) 

AUTHOR 

William  Beckett  (UW) 
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NAME 

mult  -  generate  a  cmos  multiplier  layout  (version  IJ)). 

SYNOPSIS 

molt  [options]  caesarname 
DESCRIPTION 

Utdt  is  a  module  generation  program  for  static  cmos  multiplier  circuits.  The  layout  is  pro¬ 
duced  in  'caesat'  format,  khdt  requires  a  number  of  caesar  cells  with  names  of  the  form 
mult*xa  to  exist  in  directory  yea.  These  should  be  copied  from 
$UW_VLSI_TOOLS/lib/generators/mutt  prior  to  running  mult.  The  generated  layout  is  output 
in  directory  Jc*  in  caesar  cells  with  names  of  the  form  *caesamame**xa.  Mult  is  a  cfl-based 
program  and  therefore  also  produces  v.bd  files.  'Caesarname*  may  not  begin  with  the  string 
'mult'. 

The  options  are  as  follows: 

-g  Makes  the  left  side  horizontal  bos  ground.  This  is  the  default. 

-m  mbits 

Sets  the  number  of  bits  in  the  multiplicand  operand.  Mbits  must  be  in  the  range  3  to 
32.  The  default  is  3. 

-n  nbits 

Sets  the  number  of  bits  in  the  multiplier  operand.  Nbits  must  be  in  the  range  3  to  32. 
The  default  is  3. 

-p  P_string 

labels  the  propduct  output  bits  with  labels  'P_8tring(r,  'P_stringr,  'P_string2',  etc. 
with  *P_string(r  attached  to  the  Isb.  These  labek  appear  on  the  right  side  and  the  bot¬ 
tom  side  of  the  layout.  The  default  is  *p*. 

-s  Makes  the  number  representation  sgned  (two’s  complement).  This  is  the  default. 

-a  Makes  the  number  representation  unsigned. 

-V  Makes  the  left  side  horizontal  bus  Vdd. 

-a  X_string 

labels  the  multiplicand  input  bits  with  labels  'X_string(r,  'X_stringr,  'X_5tring2',  etc. 
with  'X_string(r  attached  to  the  bb.  These  labels  appear  on  the  top  side  of  the  layout. 
The  default  is  *x*. 

-y  Y_string 

labels  the  multiplier  input  bits  with  labels  T.stringir,  'Y_5tringr,  'Y_string2',  etc. 
with  'Y_stringO'  attached  to  the  Isb.  These  labels  appear  on  the  left  side  of  the  lay¬ 
out.  The  default  is  *y*. 

FILES 

Jcz/caesarname*ja 

Jc3Jcaesarname*.hd 

Jca/mult*jen 

SEE  ALSO 

caesar(CADl),  cfl(S.vlsi) 

AUTHORS 

Wayne  E.  Winder 
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NAME 

netlist  -  a  simple  network  description  language  for  VLSI  circuits 
SYNOPSIS 

ncUlst  iitfile  [outfUe}  [-«|  [-Uech]  [-aunits]  (-sn]  [-dn^]  [-en^]  [-In^] 

DESCBIPTION 

Netlist  requires  an  input  file  with  any/all  extensions  on  the  command  line.  An  optional  output 
file  can  be  specified.  Additional  options  are  described  below; 

-o  Uses  old  input  format.  Size  specifications  are  taken  to  be  length/width  rather  than 

width/length. 

-Uech  Uses  teeh  in  the  technology  portion  of  the  units/tech  line  at  the  beginning  of  the 
simulation  file  produced  (Default  is  nmos). 

-uuttits  Sets  the  number  of  centi-microns  per  lambda  to  units  (Default  is  2S0).  Warning: 

The  'units*  set  by  this  option  appear  in  the  comment  line  of  the  jim  file.  This 
value  is  not  used  by  PRESIM  and  does  not  influenee  an  RNL  simulation. 

-sfi  Uses  number  n  as  initializer  for  internal  node  names;  useful  when  you  want  to 
merge  the  results  of  separate  netlist  runs. 

-dn,  fl  Sets  the  default  width  to  n  and  length  to  m  for  depletion  devices.  The  defaults  ate 
n=8  and  ffi=2. 

-cn,  R  Similar  to  -d  except  for  enhancement  devices.  The  defaults  are  r=2  and  m=2. 

-Ir.  r  Similar  to  -d  except  for  intrinsic  devices.  The  defaults  are  r=2  and  ri=2. 

-Ir,  r  Similar  to  -d  except  for  low'power  devices.  The  defaults  are  n=2  and  m=2. 

-p  R,  R  Similar  to  except  for  p-channel  devices.  The  defaults  are  r»2  and  m»2. 

In  addition,  if  node  alias  records  (=  nodel  node2  ...)  are  declared  using  'connect'  (See  netlist 
reference  documents)  they  appear  in  a  file  with  the  name  'basename.al*.  The  basename  is  the 
input  file  name  minus  its  last  extension. 

Netlist  is  a  macro-based  language  for  describing  networks  of  sized  transistors.  Names  in  netlist 
refer  to  nodes,  which  presumably  get  interconnected  by  the  user  through  transistors.  Macros 
for  describing  transistors  can  be  found  in  the  NETUST  User’s  Guide.  In  addition  to  transistor 
macros  netlist  provides  macros  that  allow  the  user  to  set  node  capacitance,  specific  node  delays 
(in  tenths  of  nanoseconds),  and  transistor  threshold  voltages.  The  user  may  also  define  his 
own  macros. 

The  load  command  uses  the  environment  variable  RNLPATH  (default 
.:$UWyLSIJOOLSIliblrnl).  See  the  NETUST  User’s  Guide  for  details. 

SEE  ALSO 

presim(l.vla),  rn/(l.vlsi), 

NETUST  User’s  Guide,  VLSI  Design  Toob  Reference  Manual,  UW/NW  VLSI  Consortium, 
University  of  Washington, 

AUTHOR 

Christopher  Terman  (MIT) 


UW/NW  VLSI  Release  2 


1 


4/30/84 


PADS(l.VLSI) 


VLSI  CAD  TooU  Manual 


PADS(l.VLSI) 


NAME 

pads  -  generate  a  cmoa  padframe  layout  (version  ID) 

SYNOPSIS 

pads  eaesarnante  <  frame_3pee 
DESCRIPTION 

pads  is  a  module  generation  program  for  a  MOSIS  3  micron  cmos  padframe  layout.  This  gen¬ 
erator  uses  leaf  cells  derived  from  the  MIT  pads  received  from  MOSIS.  The  leaf  cells  and  the 
layout  that  is  produced  are  in  'caesar*  format.  Pads  looks  for  caesar  leaf  cells  with  names  of 
the  form  pad*xa  in  the  directory  Jca.  These  should  be  copied  from 
$UW_VLSI_TOOLS/lib/generators/pads  prior  to  running  pods.  Pads  also  reads  in  a  frame_spec 
file  from  the  home  directory  (not  Jca).  The  frame_spec  file  definition  is  provided  in  the  text 
that  follows.  The  generated  layout  cells  (composition  cells)  appear  in  directory  Jca  with 
names  caesamame«xa.  Pads  is  a  cfi-based  program  and  therefore  also  produces  *.bd  files. 
'Caesamame'  may  not  begin  with  the  string  'pad*. 

There  are  no  options. 

FRAME.SPEC 

The  frame  specification  is  a  text  file  made  up  of  one  frame  specifier  followed  by  several  pad 
specifiers.  Tliese  records  are  terminated  with  *;*  and  may  cross  line  boundaries.  Individual 
fields  within  records  should  not  cross  line  boundaries.  The  syntax  is  *c-like';  comments  may  be 
placed  anywhere  with  the  /*  ...  */  convention. 

The  frame  specifier  is  made  up  of  a  type  specifier  followed  by  an  optional  connection  layer 
specifier.  The  type  specifier  is  one  of  C28_46x34,  C40_46x68,  C40_69x68,  C64_ 69x68, 
C64_79x92,  or  C84_79x%  (the  first  number  indicates  the  number  of  pins  on  the  frame,  the 
second  and  third  numbers  give  the  x  and  y  dimensions  of  the  entire  frame  in  hundreds  of 
microns).  The  connection  layer  specifier  indicates  what  material  connects  the  individual  pad 
circuitry  to  the  interior  of  the  chip  (across  the  quard  ring).  This  specifier  may  be  METAL2 
or  POLY.  Default  is  POLY. 

The  pad  specifiers  are  used  to  determine  the  type  of  circuitry  to  place  on  specific  pad  sites. 
Pad  specifiers  are  made  up  of  pin  number,  pad  type,  and  optional  label  and  connection 
specifiers. 

The  pin  number  is  an  integer  between  1  and  the  number  of  pins  for  the  frame  specified  (see 
above).  For  the  28  pin  frame,  pin  number  1  is  in  the  middle  of  the  right  side  of  the  frame. 
For  the  40  and  64  pin  frames,  pin  number  1  is  immediately  above  the  middle  of  the  right  side 
of  the  frame.  For  the  84  pin  frame,  pin  number  1  is  the  rightmost  pin  on  the  top  of  the 
frame.  Pin  numbering  precedes  counterclockwise  in  all  cases. 

The  pad  type  is  one  of  padlvdd  (power),  padlgnd  (ground),  padlin  (input),  padlout  (output), 
padlttl  (ttl  output),  padlts  (tri  state  output),  padlbin  (buffered  input),  padlbit  (buffered  ttl 
input)  or  padlqi  (frame  spacer  •  never  required). 

The  optional  label  specifiers  are  of  the  form  ’BP  =  label’,  ’Ll  =  label’,  ’L2  =  label’  and  ’L3  = 
label’.  BP,  LI,  L2  and  L3  indicate  where  on  the  pad  circuitry  to  place  the  label;  on  the  bond¬ 
ing  pad,  on  the  leftmost  connection  on  the  bottom  of  the  pad  circuitry  (when  viewed  with 
bonding  pad  on  top),  second  from  left  and  third  from  left,  respectively.  ’Label'  is  any  string 
beginning  with  a  letter  and  containing  only  non-special  characters.  Special  characters  include 
’»’,  ’;’  and  ’/’.  Special  characters  can  be  included  in  strinp  by  placing  double  quotes  around 
the  string  and  preceding  the  special  character  with  the  backslash  character.  For  details  of 
what  connection  connects  to  what  portion  of  the  pad  circuitry,  view  the  appropriate  circuit 
from  padl«xa  using  caesar.  The  connections  should  be  annotated  with  local  labels  to  avoid 
ambiguity.  Not  all  connections  appear  on  all  pads. 
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The  optional  connection  specifier  indicates  which  connection  to  the  interior  is  to  receive  a 
contact,  after  crossing  the  guard  ring.  This  specifier  is  of  the  form  ’CN  =  layer’,  where  N  is  1, 
2  or  3  and  is  identified  as  above.  ’Layer’  is  one  of  METAL,  POLY,  or  METAL2.  Default  is 
METAL.  If  the  layer  is  the  same  as  the  input  connection  material  (specified  in  the  first  record), 
no  contact  is  placed.  If  different,  a  contact  is  placed.  POLY  may  not  be  routed  to  METAL2 
and  vice-versa. 

RESTRICTIONS 

Pins  may  not  be  signed  more  than  once.  Only  those  pins  required  need  be  assigned. 

In  ceratin  comers  of  certain  frames,  tristate  pad  connections  do  not  cross  the  quard  ring. 

In  the  28,  40,  and  64  pin  frames,  pin  1  should  be  vdd  or  blank.  In  the  84  pin  frame,  pin  10 
should  be  vdd  or  blank. 

Each  frame  must  include  at  least  one  VDD  pad  and  one  Ground  pad.  These  pads  may  only 
connect  to  the  interior  with  METAL. 

FILES 

Jca/caesarname*£». 

JcaJcaesarnam£*.hd 
J  czt pad* 

$UW_VLSI_TOOLS/src/exampIes/pads/input 
(for  a  frame_spec  example) 

SEE  ALSO 

cfl(S.vIsi) 

AUTHORS 

Wayne  E.  Winder 
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NAME 

peg  -  finite  state  machine  compiler 
SYNOPSIS 

pef  [  -•  H  -t  1  [  nie  1 

DESCEIPTION 

Peg  (PLA  Equation  Generator)  is  a  finite  state  machine  compiler.  It  translates  a  high  level 
language  description  of  a  finite  state  machine  into  the  logic  equations  needed  to  implement 
the  state  machine  design.  Peg  uses  the  Moore  model  for  finite  state  machines,  in  which  out¬ 
puts  are  strictly  a  function  of  the  current  state.  Input  is  read  from  the  named  file  or  from 
stdin  if  no  file  is  specified. 

A  set  of  equations  is  generated  on  standard  output.  The  equations  are  in  the  eqn  format  used 
by  eqntott.  Output  from  peg  may  be  piped  directly  to  mkpla  or  tpla  thus: 

peg  inf  He  I  eqntott  I  mkpla  -i  -o  -y  n  -foutfile 
peg  iifile  I  eqntott  I  tpla  -c  -s  Bcis  -I  -O  -o  outfile 

Either  of  these  command  lines  generates  a  PLA  implementation  of  the  finite  state  machine  in 
the  file  outfilejcif.  In  the  above  command  line  for  mkpla,  n  must  be  replaced  by  the  integer 
number  of  state  bits  generated  for  the  fsm  by  peg. 

The  PLA  will  have  clocked,  dynamic  latches  on  all  inputs  and  outputs.  From  left  to  right,  the 
PLA  inputs  and  outputs  are  the  fsm  inputs,  fsm  state  inputs,  fsm  state  outputs,  and  fsm  out¬ 
puts.  llie  mkpla  result  will  feed  back  n  state  bits  from  the  PLA  outputs  to  the  PLA  inputs; 
however,  if  tpla  is  used  then  the  feedback  lines  must  be  manually  added  to  the  resulting  cir¬ 
cuit. 

Peg  options  have  the  following  meanings. 

-t  Generate  a  truth  table  for  the  fsm  in  the  file  pegjummary. 

-s  Print  summary  information  in  the  file  pegjummary. 

PROGRAM  STRUCTURE 

A  peg  program  is  composed  of  a  list  of  input  signal  names,  a  list  of  output  signal  names,  and  a 
list  of  state  descriptions,  in  that  order.  The  input  and  output  lists  are  optional. 

Inpats 

An  input  signal  list  consists  of  the  keyword  INPUTS  and  a  list  of  fsm  input  signal  names,  ter¬ 
minated  with  a  semicolon.  Every  input  list  must  have  at  least  one  input.  If  the  fsm  has  no 
inputs,  this  statement  is  omitted.  PLA  inputs  will  have  the  left-to-right  ordering  specified  in 
the  INPUTS  list. 

Ontpots 

A  list  of  output  signal  names  begins  with  the  keyword  OUTPUTS  and  is  terminated  with  a 
semicolon.  PLA  outputs  will  have  the  ordering  specified  in  the  OUTPUTS  list. 

State  List 

The  remainder  of  a  peg  program  consists  of  a  list  of  state  definitions.  A  state  definition  has 
the  form 

[  state-name  ] :  [  ASSERT  signal-list  ;  ]  (  control ;  ] 

There  is  at  most  one  ASSERT  statement  per  state  definition.  Asserted  output  signals  are  set 
to  1.  Signals  that  are  not  asserted  have  value  0. 

There  is  at  most  one  control  statement  per  state  definition.  Control  may  be  one  of 
IF  (  NOT  ]  input  THEN  state-name  [  ELSE  state-name  ] 
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GOTO  state-name 

CASE  (inpitt-signal-Ust)  selectors  ENDCASE  [Jrfau/t] 

Each  case  selector  specifies  the  next-state  for  a  particular  set  of  values  of  the  CASE  input  sig¬ 
nals.  Case  selectors  are  lines  of  the  form 

{0111?)+  =>  state-name 

If  no  control  is  specified-  by  omitting  the  ELSE  clause  from  an  IF,  by  specifying  a  CASE  with 
no  default,  or  by  omitting  control  information  entirely-  next  state  defaults  to  the  next  sequen¬ 
tial  state  on  the  state  list.  The  default  next  state  is  undefined  for  the  last  state  in  the  pro¬ 
gram.  The  qiecial  state  name  LOOP  specifies  that  the  next  state  is  the  same  as  the  current 
state. 

Comments 

Comments  may  appear  at  any  location  in  a  peg  program.  They  begin  with  a  double  dash, 
and  terminate  at  the  end  of  the  line  on  which  they  appear. 

Reset  Logic 

There  are  two  ways  of  handling  fsm  initialization.  If  the  keyword  RESET  appears  as  one  of 
the  input  signals,  then  the  fsm  will  jump  to  the  first  state  on  the  state  list  when  the  signal 
RESET  is  asserted  high.  Alternatively,  the  user  may  force  a  jump  to  the  first  state  on  the  state 
list  by  adding  logic  to  the  PLA  state  outputs  to  pull  all  of  the  state  output  lines  low  when  a 
reset  is  desired. 

Example 

The  following  peg  program  illustrates  a  variety  of  features: 

-Decode  inputs  a,  b,  and  c  into 
-0, 1, 2, 3,  or  'other'. 

INPUTS:  RESET  Select  a  b  c; 

OUTPUTS: 

FoundO  Foundl  Foond2  Founds  FoundOther; 


Start: 

-This  is  the  reset  state 

IF  NOT  Select  THEN  LOOP; 

CASE  (a  b  c)  -Second  state 

0  0  0  =>  Zero; 

0  0  1  =>  One; 

0  1 0  =>  Two; 

0  1 1  =>  Three; 

ENDCASE=>  Other; 

Zero: 

ASSERT  FoundO;  GOTO  Start; 

One: 

ASSERT  Foundl;  GOTO  Start; 

Two: 

ASSERT  Found2;  GOTO  Start; 

Three: 

ASSERT  Founds;  GOTO  Start; 

Other: 

ASSERT  FoundOther;  GOTO  Start; 

SEE  ALSO 

mkpla(CADI).  tpla(CADI).  eqntott(CADI) 

Gordon  Hamachi,  Designing  Finite  State  Machines  with  Peg 
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files 

peg  nummary  sununary  information  file 
AUTHOR 

Gordon  Hamachi 

BUGS 

The  parser  quits  after  the  first  error  is  found. 
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NAME 

pla2net  -  generate  netlist  macro  from  truth  table  of  pla 

SYNOPSIS 

plalnct  basenanu 

description 

pla2net  generates  a  netlist  macro  using  the  truth  table  definition  for  a  pla  as  an  input.  This 
truth  table  may  have  been  obtained  using  PEG  and  EQNTOTT.  pla2net  expects  that  a  file 
named  *baMiiaiiie.tt’  is  in  the  current  directory;  if  this  is  not  the  case  an  error  message  will  be 
generated.  The  output  of  pla2Mt  will  be  stored  in  a  file  named  'basenamejitV. 

The  macro  defined  in  the  ’basenameMU’  file  looks  as  follows: 

(macro  basename  (output  input)  where: 

the  basename  is  identical  to  the  basename  in  the  comnunand  line  of  plaZnet; 

output  is  an  outputvector.  numbered  from  left-to-right  as  in  the  truth  table  and  a  lay¬ 
out  generated  with  tpla  starting  with  output.l; 

input  is  an  inputvector.  number  from  left-to-right  as  in  the  truth  table  and  a  lay-out 
generated  with  tpla  starting  with  input.l. 

Note:  When  designing  pla’s  for  sequential  state  machines  with  PEG.  the  innermost  inputs 
and  outputs  of  the  pla  will  be  the  least  significant  bit.  The  state  register  inputs  and 
outputs  miut  be  wired  accordingly  (mirror  and  shift  numbering  of  input  vector  in  the 
netlist  description  for  the  top  level  sequential  state  machine,  which  includes  the 
feedback  register,  is  necessary). 

INPUT  PILE 

OUTPUT  PILE 

SEE  AL90 

Manual  entries  for  PEC-,  EQNTOTT 
AUTHOR 

Hcnnecus  Koeman.  John  Fluke  Mfg.  Co..  Inc. 

■UGS 

The  current  version  only  supports  emos  technologies.  The  source  code  can  easily  be 
modified  for  other  technologies. 
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NAME 

presim  -  a  netlist  preprocessor  for  the  ml  VLSI  circuit  simulator 
SYNOPSIS 

predm  iitfiU  outfilt  [eoitfigfUe]  [-j]  [-tfile^n]  [presist, voltage] 


DESCRIPTION 

Presim  converts  the  Atm  file  into  a  binary  file  to  be  used  by  rtU. 


The  parameters  and  options  are  as  follows: 


itrfile 

outfile 

corrfigfile 


-g 


-efite^  min 


-tfile,  min 


A  net  list  file  that  must  include  any/all  extensions; 

An  output  filename  must  be  specified  on  the  command  line; 

(optional)  A  file  to  set  lambda  and  RC  parameters  for  nodes  and  transistors  in 
the  netlist  (see  the  presim  user's  guide  for  descriptions  of  the  parameters  and  syn* 
tax). 

Suppresses  the  sum-of-products  formation.  This  may  be  desired  if  you  think 
sum-of-products  is  formed  wrong  otherwise  the  advantages  of  the  tranastor  and 
node  reduction  make  this  option  unattractive. 

Writes  a  list  of  node  names  and  capacitances  to  the  specified  file.  Only  capaci¬ 
tances  larger  than  min  will  be  included. 

Writes  a  list  of  transistors  and  RC  values  to  the  specified  file  --  there  are  two 
entries  for  each  transistor.  The  R's  come  from  the  size  of  the  transistor,  C’s 
from  the  source/drain  capacitance.  Only  RC  values  larger  than  min  will  be 
included. 


-preslat,  voltage 

Provides  a  worse-case  estimate  of  the  circuit  power  consumption  by  assuming 
that  all  the  pullups  (DEP  or  LOWP  devices  with  drain =V<fd)  are  all  on  simul¬ 
taneously.  Voltage  specifies  the  supply  voltage, 

Presim  also  attempts  to  open  the  file  bcuenameJl,  where  basename  is  defined  as  the  input  file 
name  minus  its  last  extension.  It  is  non-fatal  for  this  file  to  be  absent. 


SEE  ALSO 

PRESIM  User’s  Guide.  VLSI  Design  Tools  Reference  Manual,  UW/NW  VLSI  Consortium, 
University  of  Washington,  (Christopher  Terman,  MIT  Laboratory  for  Computer  Science). 

AUTHOR 

Christopher  Terman  (MIT) 

BUGS 

Propagation  of  X  state  information  for  cmos  circuits  in  rni  is  unreliable  if  the  gate  reduction 
in  presim  is  performed.  If  this  information  is  required,  suppress  gate  reduction  with  the  -g 
option  in  presim. 
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NAME 

presto  -  combinational  logic  minimization  program 
SYNOPSIS 

presto 

DESCRIPTION 

Pretto  is  an  efficient  combinational  logic  minimization  program.  This  program  not  only 
reduces  the  number  of  product  terms,  increases  the  number  of  don’t  care  inputs,  but  also 
reduces  the  number  of  the  output  connections.  Therefore,  this  program  is  very  useful  to  pla 
designers. 

Input  is  taken  from  standard  input.  Output  goes  to  standard  output. 

An  example  of  typical  input  is  as  follows: 
i4 
jo2 

J 

.p4 
10x1  11 
OOOx  lx 
nil  01 
0101  10 
Jt 

The  integer  after  '.i'  is  the  number  of  input  variables.  The  integer  after  "jo"  is  the  number  of 
output  variables.  The  integer  after  '.p*  is  the  number  of  input  product  terms.  "J*  is  optional 
for  input  listing.  There  is  another  option  "ji"  for  intermediate  results. 

In  the  input  part,  1  means  logic  level  1,  0  means  logic  level  0,  x(or  -)  means  don’t  cate.  In  the 
output  part,  1  means  that  the  term  is  connected  to  the  output,  0  means  that  this  term  is  not 
connected  to  the  output,  and  x(or  -)  means  that  the  output  doesn’t  care  whether  this  term  is 
connected  or  not.  *.e'  means  the  end  of  the  input  file.  When  there  is  a  format  error  in  the 
input  file,  the  program  will  give  the  message:  'INPUT  FORMAT  ERROR.i*  and  abort  the  job. 
AUTHOR 

Sheng  Fang 
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NAME 

pspice  -  prepare  an  input  file  for  the  Spice  circuit  simulator 
SYNOPSIS 

pspice  [-rm]  [-nos2s]  [-d  defsfUe]  [-m  modelfiU]  [-c  expfile]  basename 
DESCRIPTION 

Pspice  is  a  shell  script  for  preparing  Spice  input  from  information  from  several  sources.  Pspice 
runs  simlspice  to  convert  from  a  basename  format  circuit  description  to  a  Spice-compatible 
description  and  modifies  the  sim2spice  node  label  translation  table  to  be  acceptable  Spice  com¬ 
ments.  It  then  runs  spcpp  to  translate  a  pseudo-Spice  formatted  file  that  contains  symbolic 
node  labels  to  a  Spice-acceptable  file.  Finally,  pspice  concatenates  the  circuit  description  file, 
the  translation  table,  a  file  of  untranslated  Spice  input,  and  the  translated  Spice  input  into  a 
single  file  named  basenamejpclu.  This  file  is  usually  an  acceptable  Spice  input  file.  The 
optional  parameters  can  be  used  to  cause  parts  of  this  process  to  be  skipped. 

The  options  and  parameters  are: 

-nos2a  Suppresses  the  execution  of  the  simlspice  step. 

-rm  Indicates  that  the  files  created  in  intermediate  steps  are  to  be  deleted. 

-d  defsfile  Specifies  a  file  to  be  used  as  a  simlspice  definitions  file. 

-m  modelfile  Specifies  a  file  that  contains  Spice  input  that  is  to  be  included  (untranslated)  in 
the  final  output.  It  is  intended  that  modelfile  name  a  file  containing  Spice 
AlODEL  cards  as  well  as  other  Spice  commands  that  are  independent  of  the 
particular  circuit  being  modeled. 

-e  expfile  Specifies  a  file  that  contains  pseudo-input  for  Spice.  Spcpp  will  interpret  strings 
in  expfile  that  are  bracketed  by  ’<  ’  and  ’>  ’  as  node  names  to  be  translated 
into  spice  node  numbers  using  the  translation  table  {basename jume*)  created 
by  simlspice.  Lines  containing  bracketed  tokens  are  converted  into  Spice  com¬ 
ments.  It  is  intended  that  expfile  contain  Spice  commands  that  describe  the 
experiment  to  be  simulated  on  the  circuit.  The  ability  to  use  nmemcnic  node 
names  makes  the  preparation  of  Spice  input  much  easier  and  it  means  that  the 
description  of  the  experiment  need  only  be  specified  once,  even  if  the  circuit  is 
modified  and  reextracted.  If  expfile  is  not  specified  then  spcpp  is  not  executed. 

basename  Specifies  the  base  name  for  the  files  describing  the  circuit.  If  simlspice  is  run 
then  a  file  named  basename ,dba  must  exist.  If  simlspice  is  not  run  then  the  files 
basename jamssu*  and  basename  jplce  must  exist. 

FILES 

basenamemm  circuit  description  input  to  simlspice 

defsfile  optional  simlspice  defs  input 

basename. iximei  modified  simlspice  translation  table  output.  This  is  read  by  spcpp  (•) 
hasemime .spice  simlspice  output  Spice  format  circuit  element  definitions  (•) 

modelfile  optional  Spice  AIODEL  commands  to  be  included  in  basename  speia 

expfile  input  to  spcpp  containing  pseudo-spice  commands  describing  the  experiment 

to  be  simulated 

basenamespex  translated  output  from  spcpp  (•) 

basename  speia  The  Spice  input  deck  created  by  concatenating  basename  splCK, 

basename  Musut,  modelfile,  and  basename  .spex 

Note:  Files  marked  (•)  are  deleted  by  the  -rm  option. 

SEE  ALSO 

sim2spice(l.vl$i),  spcpp(l.vlsi) 
spice(l.vlsi) 
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inextra(l.vlsi),  cifplot(CADl) 

AUTHOR 

Robert  Fowler  (UW/NW  VLSI  Consortium,  University  of  Washington) 

DIAGNOSTICS 

The  error  messages  are  intended  to  be  self  explanitory.  Note  that  sim2spice  and  spcpp  produce 
their  own  error  messages. 

BUGS 

The  command  line  is  long  enough  to  tempt  a  user  to  call  pspice  from  yet  another  shell  script. 
A  better  way  to  do  this  is  to  set  up  an  alias  for  pspice  with  the  commonly  used  options  already 
set. 
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NAME 

rnl  -  timing  and  logic  simulator  for  VLSI  circuits 

SYNOPSIS 

ml  [cmdfUe] 

DESCRIPTION 

Rnl  (NetLisp)  is  a  timing  logic  simulator  for  digital  NMOS  circuits  with  a  lisp-like  command 
interpreter.  It  has  also  been  used  with  many  CMOS  circuits  with  some  success.  The  Rnl 
User's  Guide  discusses  some  of  the  limitations  found  in  simulating  CMOS  circuits.  To  use  rnl, 
one  needs  a  .aim  file  for  the  circuit  to  be  simulated.  This  can  be  derived  from  the  mask  file 
(e.g.,  CIF)  or  developed  using  netlist,  a  program  that  processes  textual  schematics. 

One  must  first  convert  the  Jtm  file  to  a  network  file  suitable  for  use  by  rnl.  To  do  this  run 
presim: 

preslm  filename jAsss  netfile  [config_parasns\ 

which  converts  the  file  fitename jslm  into  netfile,  a  binary  file  for  rnl.  (see  Presim  User's  Guide 
for  information  on  the  various  configuration  parameters. 

The  optional  cmdfile  is  the  file  rnl  initially  reads  for  user  input.  Usually  one  prepares  a  com¬ 
mand  file  that  loads  one  or  more  library  files  containing  RNL  function  definitions  and  reads  in 
the  network  from  netfile.  As  simulation  proceeds,  user  defined  functions  developed  for  test¬ 
ing  the  circuit  can  be  added  to  the  command  file.  At  a  minimum  the  command  file  should 
contain  the  commands 

(load  *uwstdi*) 

(load  'uwsimi^ 

(read-network  “netfile*) 

When  using  the  load  command  both  netlist  and  rnl  search  the  current  directory  and  then  any 
directories  specified  in  the  environment  variable  RNLPATH.  The  value  of  RNLPATH  defaults 
to  SUWyLSlJOOLSIliblrnl.  Read-network  does  not  use  RNLPATH.  Netfile  must  be  pro¬ 
duced  by  presim.  When  the  end-of-file  is  reached  in  the  command  file,  input  is  taken  from 
stdin.  Commands  and  formats  to  be  used  are  given  in  the  RNL  User's  Guide. 

The  top  level  of  rnl  is  a  simple  loop: 

(1)  read  command  from  current  input; 

(2)  evaluate  command,  performing  specified  actions; 

(3)  print  the  result  and  loop  back  to  (1). 

The  following  is  a  list  of  the  objects  that  rnl  knows  about 

numbers  -•  signed  integen.  (16  bits  on  PDPlls,  24  bits  on  VAXen,  28  bits  on  PDPlOs). 

~  fioating  point. 

strings  sequences  of  characters  enclosed  in  quotes  (*).  Useful  as  constants  for  file 

names,  print  statements,  etc.  Special  characters  can  be  introduced  into  the 
strings  by  using  the  backslash  escapes: 

\n’  newline 

\t'  return 

%t’  tab 

^ooo’  ascii  code  'ooo*  where  ooo  are  octal  digits 

symbols  variable  names.  Any  sequence  of  characters  that  isn’t  a  number,  string,  or  some 
special  character  --  starting  symbols  with  a  letter,  followed  by  more  letters, 
numbers,  and  punctuation  is  usually  a  safe  bet. 

nodes  an  electrical  node. 
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lists  a  sequence  of  objects  enclosed  in  parentheses.  Standard  LISP  syntax  applies, 

including  dot  notation.  The  empty  list  *()*  is  also  called  "nil”. 

subrs  primitive,  or  built-in,  functions  (like  +). 

The  functions  are  listed  by  application  area.  The  areas  are: 

•  arithmetic  functions 

-  predicates 

•  list  functions 

-  I/O  functions 

•  miscellaneous  functions 

-  special  forms 

-  network/simulation  functions 

-  functions  defined  in  *uwsimJ* 

SEE  ALSO 

tiettist(l.vlsi),  presim(l.vlsi),  simfile(5.vlsi) 

RNL  User's  Guide,  VLSI  Design  Toob  RrfercBce  Mannal,  UW/NW  VLSI  Consortium,  Univer¬ 
sity  of  Washington,  (Christopher  Terman,  MIT  Laboratory  for  Computer  Science). 

AUTHOR 

Christopher  Terman  (MTT) 

BUGS 

User  defined  macros  with  the  same  name  as  a  node  in  the  net  list  puts  rnl  into  an  infinite 
loop. 

Propagation  of  X  state  information  for  cmos  circuits  is  unreliable  if  the  gate  reduction  in 
presim  is  performed.  If  this  information  is  required,  suppress  gate  reduction  with  the  -g 
option  in  presim. 
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NAME 

rulec  -  Compile  design  rules  for  Lyra 

SYNOPSIS 

raise  [-lo]  rules 

DESCRIPTION 

Rulee  is  a  shell  script  with  the  following  processing  steps: 

i)  The  actual  Lyra  rule  compiler  is  invoked  to  translate  the  symbolic  rule  description, 
rules  J,  to  lisp  code,  rulesd. 

ii)  The  lisp  compiler,  Liszt,  is  invoked  to  compile  rulesA  to  rulesja 

iii)  rules*  is  loaded  into  Lyraproto  to  generate  an  executable  lisp  Lyra,  rules. 

iv)  The  intermediate  files  rules!,  and  rules*  are  deleted. 

The  following  options  are  supported: 

-1  (load  only)  No  compilation  is  done.  Previously  compiled  rules,  rules*,  are  loaded  into 
Lyraproto  to  generate  an  executable  Lyra,  rules.  This  option  is  useful  mainly  at 
Berkeley,  where  Lyraproto  changes  frequently. 

-o  (save  object)  Name*  is  not  removed.  Enables  ’raise  -I  rules’  in  the  future. 

nLES 

*cad/bin/rulec  •*  rulec  shell  script. 

'cad/lib/lyra/RuIecl  -  lisp  rule  compiler 
'cad/Iib/lyra/Lyra.proto  ••  Lyra  sans  compiled  rules  code. 

*cad/lib/lyra/«x  ••  standard  rulesets. 

'cad/lib/Iyra/DEFAULTS  ••  gives  default  rulesets  for  Caesar  teehnologies. 

SEE  ALSO 

Lyra  (CAD) 

List  (1) 

AUTHOR 

Michael  Arnold. 


3rd  Berkeley  Distribution 


10/24/82 


1 


SIM2SPICE(CAD1) 


UNIX  Programmer’s  Manual 


SIM2SPICE(CAD1) 


NAME 

simZspice  -  convert  from  meztra  format  to  Spice  (circuit  simulator)  format 
SYNOPSIS 

■Iml^pke  [-d  dffi]  bateiiamejtm 
DESCSIPnON 

SinQspice  reads  the  basenemuMm,  basenameMAt*  and  basenanujl  files  created  by  mextra  and 
creates  a  Spice  readable  circuit  description,  basename  Spice  requires  node  numbers  and 

simZspiet  generates  a  translation  table  basenamejkamu  which  shows  the  mextra  nodelabel 
corresponding  to  a  given  node  number. 

The  user  can  q)ecify  his/her  own  translation  table  by  using  the  -d  option,  where  drfs  is  a  file 
of  definitions.  A  definition  can  be  used  to  set  up  equivelences  between  jlm  node  names  and 
Spice  node  numbers.  The  form  of  this  type  of  definition  is: 

set  simjumu  spieejuunber  (rccA) 

The  tech  field  is  optional.  In  nMOS,  a  ^Mxial  node,  ‘BULK*,  is  used  to  represent  the  substrate 
node.  For  cMOS,  two  special  nodes,  ’NMOS’  and  TMOS*,  represent  the  substrate  nudes  for 
the  ’n’  and  ’p’  transistors,  repectively.  For  example,  for  nMOS  the  Mm  node  ‘GND’ 
corresponds  to  Spice  node  0,  ‘Vdd*  corresponds  to  Spice  node  1,  and  ‘BULK’  corresponds  to 
Spice  node  2.  The  d^s  file  for  this  set  up  would  look  like  this: 
set  GND  0  nmos 
set  Vdd  2  nmos 
set  BULK  3  nmos 

A  definition  also  allows  you  to  set  a  correspondence  between  transistor  types  and  and 
Spice  transistor  types.  The  form  of  this  definition  is: 
def  simjraiu  spicejrans  [tech\ 

Again,  the  tech  field  is  optional.  For  nMOS  these  definitions  would  look  as  follows: 
def  e  ENMOS  nmos 
def  d  DNMOS  nmos 

Definitions  may  also  be  placed  in  the  ‘xadre’  file,  but  the  definitions  in  the  deft  file  overrides 
those  in  the  ‘xadre’  file. 

Sim2spice  also  reads  ‘N’  lines  generated  by  mextra  with  the  -o  switch.  In  order  to  compute 
capacitances  from  this  it  must  have  a  set  of  conversion  factors  between  length/area  and  capaci¬ 
tance.  These  are  specified  in  the  sim2spice  section  of  ‘.cadre’  file  in  exactly  the  same  format  as 
in  the  mextra  section  of  the  ‘xadre’  file  (see  mextra). 

The  program  has  been  extended  so  that  a  comment  line  beginning  with  *l=”  is  interpreted  as 
an  MIT  xtm  style  node  equivalence  line. 

To  create  a  complete  Spice  input  file  it  is  necessary  to  append  applicable  Spice  model  descrip¬ 
tions  as  well  as  the  user’s  Spice  simulation  commands  to  the  batename  jplca  file. 

It  is  recommended  in  most  cases  that  the  user  run  pspice  rather  than  simZspice.  Pspiee  incor¬ 
porates  the  features  of  sim2spice  but  will  in  addition  allow  the  user  to  build  all  of  the  Spice 
input  file  in  one  step.  Ptpice  also  incorporates  the  features  of  tpepp. 

FILES 

basenamesam 
baseiiame. noda 
batename^ 
basenamexpicc 
baseiuime. names 
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SEE  ALSO 

meztn(l.vlsi),  spice(l.vlsi).  |»pice(l.vlsi).  spcpp(l.vlsi) 

AUTHOR 

Dan  Fitzpatrick  (UCB) 

MODIFICATIONS 

Neil  Soiffer  (UCB)  ~  cMOS  fizes. 

Rob  Fowler  (UW/NW  VLSI  Consortium.  University  of  Washington)  -  node  equivalence  han¬ 
dling  and  misc.  bug  fixes. 

BUGS 

The  only  pre-defined  technologies  are  ‘nmos’  and  *cmos-pw'.  Only  one  definition  file  is 
allowed. 

Warning:  for  nMOS  circuits  the  node  names  *ENMOS*  and  *DNMOS”  are  preempted  by 
simZspice  as  synonyms  for  *BULK'. 

The  node  equivalence  handling  is  not  completely  general.  New  nodes  can  be  added  to 
equivalence  classes,  but  classes  cannot  be  merged.  This  is  detected  and  an  error  message  is 
produced. 
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NAME 

simscope  -  view  time-series  of  simulator  output. 


SYNOPSIS 

stnucope 

DESCRIPTION 

simscope  is  designed  to  display  signal  output  produced  by  RNL  or  SPICE  on  a  Tek  4105  or  a 
GP-19  graphics  terminal.  To  make  hardcopies,  you  need  a  Tek  4695  printer  (or  compatible 
hardcopy  device)  in  conjunction  with  the  Tek  4105  graphics  terming.  Any  program  that 
might  periodically  interfere  with  the  display,  notably  sysline,  should  be  switched  off. 

Gcncml  Rnlca  for  Udag  simseopet 

1.  Names  to  be  entered  in  response  to  simseope't  requests  may  contain  alpha  as  well  as  numer¬ 
ical  characters. 

2.  Numbers  to  be  entered  in  response  to  simscope'*  requests  may  be  fixed-point  or  fioating- 
point  numbers  (the  latter  format  is  also  referred  to  as  scientific  notation).  Examples  of 
fixed-point  numbers  are  123,  3J5,  +45000,  etc.  Examples  of  numbers  in  scientific  notation 
are  3.5e4,  0333e-9,  O.le-9,  +244.5e05,  etc.  Numbers  may  not  be  negative  (negative  time 
scales,  times,  and  positions  do  not  make  sense  to  simscope). 

3.  While  entering  a  name  or  a  number,  characters  typed  erroneously  may  be  deleted  with 
either  the  RUBOUT  key  (CONTROL-H  is  equivalent)  or  the  BACKSPACE  key 
(DELETE  on  some  keyboards). 

4.  All  numbers  di^layed  by  simscope  are  in  scientific  notation.  The  mantissa  consists  of  one 
digit,  a  decimal  point,  another  six  digits,  the  'e'  indicating  the  exponent,  the  sign  for  the 
exponent,  and  two  digits  for  the  exponent. 

5.  After  reading  a  behavior  file,  simscope  uses  the  same  time  units  as  those  used  in  the 
behavior  file.  These  are  nanoseconds  (ns)  in  RNL-generated  files  and  seconds  (s)  in 
SPICE-generated  files. 

6.  Indeterminate  RNL  signals  (state  'X”)  are  displayed  with  a  logic  level  of  03. 


Bow  to  Start  and  Exit  simscope 

Work  with  simscope  is  most  convenient  if  you  change  to  the  directory  that  contains  the 
behavior  file  you  want  to  view.  Being  in  that  directory,  simply  enter  si/nscope.  simscopecomes 
up  with  a  greeting  display.  The  window  begin  and  end  times  are  set  to  0  (B  =  01X10000+00 
and  E  «  0IXXXXX)+O0)  and,  consequently,  the  time  scale  is  0  (T  =  0.000000+00),  too.  The 
mode  (see  below)  is  set  to  fixed-time-scale  mode.  The  Y-scale,  in  units  per  division,  is  set  to  1 
(Y  -  lDOOOOO+00). 

Below  these  indicators  the  menu  is  displayed,  followed  by  the  request  that  you  hit  a  key  indi¬ 
cating  the  menu  function  you  wish  to  select.  Valid  keys  are:  f,  n,  b,  e,  t,  y,  c,  d,  s,  r,  and  q, 
all  of  which  may  be  entered  as  capitals  (with  the  SHIFT  key).  Each  letter  represents  the  first 
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letter  of  the  corre^xinding  menu  function  (see  below).  After  you  press  any  of  these  keys,  the 
corresponding  function  is  immediately  activated  -  no  RETURN  is  necessary. 

To  exit  simseope,  press  the  *q*  key  (Quit). 


simscope  FonctloBS 
file 

This  function  serves  two  purposes.  First,  it  provides  the  following  information  about  the  file 
presently  loaded: 

name  of  present  behaviour  file 

file  begin  time  (the  time  of  the  first  signal  entry  in  the  file) 
file  end  time  (the  time  of  the  last  signal  entry  in  the  file) 
for  each  signal  in  the  file: 

first  change  (the  time  of  the  first  entry  of  the  signal  in  the  file) 

last  change  (the  time  of  the  last  entry  of  the  signal  in  the  file) 

y-position  (the  vertical  position  of  the  signal  in  the  display;  a  number  between 
1  and  99,  1  is  the  lower  end  of  the  window,  99  is  the  upper  end  of  the  win¬ 
dow). 

name  (the  signal’s  name) 

The  second  purpose  of  the  File  function  is  to  facilitate  the  loading  of  a  different  file.  If  you 
press  'y*  (yes)  in  reply  to  the  function  prompt.  File  will  ask  you  for  the  name  of  the  new 
behaviour  file  you  want  to  load.  Any  other  key  will  terminate  the  File  function,  display  all 
signals,  and  return  you  to  the  menu.  If  you  enter  a  name,  the  corresponding  file  is  read. 
Reading  the  behaviour  file  may  take  awhile,  during  which  time  the  cursor  may  flash  at  various 
positions  on  the  screen  (hence  the  message:  'Reading  file.  Please  wait.  Don’t  worry  if  the  cur¬ 
sor  flashes  a  bit.”). 

Nodes 

You  will  be  asked  for  a  node  name  (default  is  the  node  last  entered),  simscope  then  asks 
whether  you  want  to  display  the  node’s  signal  or  delete  the  node’s  signal  from  the  display,  -t- 
or  just  RETURN  means  display,  -  means  delete  from  diq>lay  (the  y-position  of  the  signal  is 
set  to  zero).  Next  simscope  asks  for  the  position  (vertically)  in  the  window.  Enter  99  for  the 
very  top  of  the  window,  1  for  the  bottom  of  the  window,  any  number  between  1  and  99  for  an 
intermediate  position.  (One  division  on  the  y-scale  is  equivalent  to  S  positional  units.) 
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Reposition  a  signal  by  entering  its  name  with  Nodes,  then  enter  the  desired  new  position. 

Assuming  that  you  normally  want  to  change  more  than  one  signal  in  a  row,  file  information 
(as  in  the  File  function)  is  displayed  after  you  enter  a  y-position,  providing  you  with  a  sum¬ 
mary  of  the  information  on  all  nodes  if  the  behaviour  file. 

Use  the  Display  function  to  display  the  signals. 

■egla 

Sets  the  window  begin  time  (”B  -  *  at  left  side  of  the  window). 

In  fixed-time-seale  mode,  a  change  of  the  window  begin  time  moves  the  window  (whose  time 
width  remains  unchanged)  across  the  file. 

In  fixed-window-end  mode,  a  change  of  the  window  begin  time  expands  or  contracts  the  win¬ 
dow  in  a  "rubber-band-like*  fashion. 

End 

Sets  the  window  end  time  (”E  =  '  at  right  side  of  the  window). 

The  time  scale  will  be  readjusted  automatically  to  be  consistent  with  the  new  window  end 
time. 

The  window  begin  time  is  not  affected. 

Setting  the  window  end  time  will  switch  over  to  fixed-window-end  mode.  In  this  mode 
changes  to  the  window  begin  time  will  not  affect  the  window  end  time,  but  will  readjust  the 
time  scale.  You  can  use  End  for  switching  to  fixed-window-end  mode  (without  actually  chang¬ 
ing  the  window  end  time)  by  confirming  the  present  (default)  value  of  the  end  time.  To  do 
that  press  *e',  then  just  hit  RETURN. 


Sets  the  time  scale  of  the  window  ('T  =  *  below  the  window). 

The  window  end  time  will  be  readjusted  automatically  to  be  consistent  with  the  new  time 
scale. 

The  window  begin  time  is  not  affected. 

Setting  the  time  scale  will  switch  over  to  fixed-time-scale  mode.  In  this  mode,  changes  to  the 
window  begin  time  will  not  affect  the  time  scale,  but  will  readjust  the  window  end  time.  You 
can  use  T-scale  for  switching  to  fixed-time-scale  mode  (without  actually  changing  the  time 
scale)  by  confirming  the  present  (default)  value  of  the  scale.  To  do  that  press  ”t',  then  just  hit 
RETURN. 


Y-scale 

Sets  the  vertical  scale  in  units  per  division  (*Y  -  *  below  *B  =  ').  The  default  is  1,  which  is  a 
good  value  for  RNL.  The  vertical  extent  of  SPICE  signals  is  usually  larger,  however  (for 
example  5  Volts,  i.e.  S  units).  Increasing  the  Y-scale  allows  you  to  fit  more  of  the  larger  sig¬ 
nals  on  the  screen  without  overlapping. 
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Copy 

To  make  hardcopies,  you  need  a  Tek  410S  and  a  Tek  469S  printer  (or  compatible  device).  (If 
you  activate  the  Copy  function  on  a  GP-19  terminal,  you  will  get  the  message:  'Use  a  Tek  4105 
terminal.  (You  can  also  use  MTP).  Hit  any  key  to  continue.*) 


Display 

All  signals  with  a  y-position  greater  than  1  are  displayed.  Use  this  function  to  display  the  sig¬ 
nals  after  you  have  made  changes  for  any  node  (deletion,  positioning  or  repositioning),  or  if 
you  want  to  refresh  the  di^lay  for  any  reason. 


Save 

All  parameters  determining  the  particular  display  state  are  saved  for  later  retrieval.  'Save* 
first  asks  you  for  a  name  of  the  file  in  which  you  want  to  keep  the  present  state.  It  then  saves 
in  this  file  the  present  behaviour  file  name,  window  begin  time,  time  scale,  window  end  time, 
mode  (1  for  fixed-time-scale  mode,  0  for  fixed-window-end  mode),  and  the  names  of  ail 
displayed  signals  with  their  positions  on  the  y-axis. 

Saved  states  can  be  restored  easily  with  the  Retrieve  function.  You  may  conveniently  con¬ 
sider  the  names  of  'Save*  files  as  markers  (possibly  with  short  names  like  1,  2,  3,  ...,  or  al, 
registers,  LoadlO,  etc.),  which  can  be  'jumped  to*  with  the  Retrieve  function. 


Retrieve 

Retrieve  is  the  function  used  to  restore  a  previously  saved  diq>lay  state.  You  are  asked  for 
the  name  of  the  file  containing  the  state  to  be  restored.  If  the  state  you  want  to  restore 
belongs  to  a  behaviour  file  different  from  the  one  on  which  you  are  working  presently,  then 
the  new  behaviour  file  is  read  (this  may  take  some  time). 

Quit 

This  function  terminates  simscope  and  returns  you  to  the  UNIX  shell. 


The  nsc  of  simscope  to  display  RNL  or  SPICE  results  Involves  the  following  steps: 

1.  Generate  a  behavior  file. 

(a)  If  you  are  using  RSL,  the  directive 
openplot  " behavior -fUtf 

will  cause  the  changes  to  all  traced  nodes  to  be  written  to  behavior-file  in  addition  to 
being  written  to  the  terminal.  Quotes  are  necessary  if  the  file  name  has  any  punctua¬ 
tion  in  it. 
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The  RNL  directive 
closeplot 

will  terminate  the  behavior  file.  If  the  entire  RNL  session  is  to  be  recorded  closeplot  is 
not  required,  as  the  file  will  be  terminated  when  RNL  exits. 

(b)  If  you  are  using  SPICE,  a  behavior  file  may  be  specified  as  the  third  positional  param¬ 
eter  of  the  SPICE  command.  Behavior  records  will  be  put  on  this  file  for  all  nodes 
specified  on  the  SPICE  PLOT  directive. 

2.  Use  the  F  (File)  function  of  simscope  to  load  the  behavior  file  and  get  information  on  the 
signals  stored  in  it. 

Use  simscope'%  other  menu  functions  to  display  any  signal  in  the  file  on  any  position  (vert¬ 
ically)  on  the  screen,  change  the  time  scale  (window  size)  and  window  position.  After  you 
have  analyzed  and  positioned  your  signals,  make  a  hard-copy,  if  desired. 

EXAMPLE  (PrcpantlMi  ef  a  Bcharlenr  File  with  RNL) 

The  following  example  uses  simscope  to  display  the  behavior  of  a  10  bit  counter,  cntrlOnet, 
shown  here  in  netlist  format: 

;  net  file  for  10-bit  counter 

;  half  adder  made  from  gates 
(macro  half  adder  (a  b  s  c) 

(local  hi  h2  h3) 

(nand  (hi  2  16)  a  b) 

(nand  (h2  2  16)  a  hi) 

(nand  (h3  2  16)  b  hi) 

(nand  (s  2  16)  h2  h3) 

(invert  c  hi) 

) 

;  one  cell  of  a  counter 
(macro  cell  (in  out  Cin  Cout) 

(local  cl  c2  c3) 

(invert  cl  in) 

(trans  phil  cl  c2) 

(invert  c3  c2) 

(half_adder  c3  Cin  out  Cout) 

(trans  phi2  out  in) 

) 

;  declare  global  node  names 
(node  count  c  in  out  phil  phi2) 

;  carry-in  to  first  significant  bit  controls  counting  action 
(connect  count  c.O) 

:  generate  the  counter 
(repeat  i  1 10 
(capacitance  out.i  1.234) 
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(cell  ina  out  j  c.(l-  i)  ci) 

) 

The  RNL  control  file,  cntrlOJ,  is  as  follows: 

;  RNL  initialization  file  for  10  bit  ripple-carry  counter 

(load  'uwstdJ”) 

(load  'uwsimJ'^ 

(read-network  'cntrlOJ 

:  (setq  report-form  nil)  This  turns  off  the  report  generator 

(setq  incr  1000) 

;  bind  symbols  to  node  names 

(chflag  *(phil  phi2  out.lO  out.9  outR  out.7  out.6 
out  J  out.4  out3  out2  out.l)) 

(defun  init  (dummy) 

(1  ’(count  in.l  in^  in  J  in.4  inj 
in^  in.7  in^  in.9  in.lO)) 

0  *(phi2)) 

(h  ’(Phil)) 

(step  incr) 

(1  ’(phil)) 

(step  incr) 

(x  ’(in.l  in.2  in3  in.4  in.S 
in.6  in.7  in.8  in.9  in.lO)) 

(h  ’(phi2)) 

(step  incr) 

(I  ’(phi2)) 

(step  incr) 

(h  ’(count)) 

(wr-report) 

’done 

) 


(defvec  ’(bit  bout  out. 10  out.9  out.8  out.7  out.6 
out  J  out.4  outJ  out2  out.l)) 
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(defvec  ’(dec  dout  out.lO  out.9  out£  out.7  outiS 
out  J  out.4  out3  out2  out.l)) 

(def-report  ’(*10  bit  counter  current  state*  newline  *  * 
count  (vec  bout)  (vec  dout))) 


Generate  the  behavior  for  the  counter  using  RSL 

netlist  cntrlOjiet  cntrlOjiim 
presim  cntrlO^im  cntrlO 
RNL  cntrlOi 

init  #  initialize  the  counter 

openplot  *cntrl0.beh*  #  open  the  behavior  file 

#  (.beh  stands  for  network  behavior  file) 


c30 

#  run  30  clocks 

exit 

#  exit  RNL 

SEE  ALSO 

RNL(l.vlsi)  SPICE(l.vlsi),  mtp(l.vlsi) 

SIMSCOPE  User’s  Guide  Release  20  Available  from  the  UW/NW  VLSI  Consortium,  Sieg  Hall, 

FR-35,  University  of  Washington,  Seattle,  WA  98195 

"User’s  Guide  to  RNL"  *VLSI  Design  Tools  Reference  Manual*,  UW/NW  VLSI  Consortium, 

University  of  Washington,  (Christopher  Terman,  MIT  Laboratory  for  Computer  Science). 

"SPICE  User's  Guide",  *VLSI  Design  Tools  Reference  Manual,*  UW/NW  VLSI  Consortium, 

University  of  Washington,  (A.  Vladimirescu  et  al.,  15  Oct.  1980) 

RESTRICTIONS 

1.  In  graphics  mode,  which  is  obviously  required  for  simscope,  the  GP-19  can  display  upper 
case  characters  only,  simscope  Rstill  recognizes,  and  processes  correctly,  lower  case  charac¬ 
ters.  You  have  to  know  which  characters  in  your  file  and  which  node  names  are  upper 
case,  and  which  are  lower  case,  and  enter  them  accordingly.  Otherwise,  simscope  may  tell 
you  that  it  does  not  know  the  name  you  entered.  The  Tek  4105  terminal  does  not  have 
this  problem. 

2.  The  File  function  does  not  recognize  the  '  (tilde)  as  part  of  a  path  name. 

3.  RNL  and  SPICE  write  only  changes  of  signal  levels  to  the  behavior  file.  Therefore,  a 
signal’s  value  before  the  first  file  entry  is  not  known,  simscope'%  strategy  to  deal  with  this 
situation  is  to  display  this  value  as  indeterminate  (0.5,  X  in  RNL). 

4.  The  number  of  signals  in  a  behavior  file  is  lim'ted  to  20  (17). 
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S.  The  length  of  behavior  files  is  restricted  to  20,000  signal  changes  (ix.  to  20,000  lines). 
This  could  be  extended  easily,  if  need  be. 

BUGS 

1.  In  case  the  number  of  signals  in  a  behavior  file  is  greater  than  20  or  the  behavior  file  con¬ 
tains  more  than  20,000  signal  changes  (ije.  to  20,000  lines),  simscope  crashes. 

2.  The  first  line  of  a  behaviour  file  is  discarded,  because  in  the  case  of  RNL  behaviour  files 
this  line  contains  irrelevant  information  different  from  the  information  of  all  other  lines. 
Therefore,  the  very  first  signal  change  of  a  SPICE  behaviour  file  is  lost.  This  is  not  noti- 
cable  in  most  cases,  however. 

3.  Some  versions  of  SPICE  produce  behaviour  files  that  contain  floating  point  numbers  for¬ 
matted  in  a  non-standard  manner.  Encountering  of  a  non-standard  format  in  the 
behaviour  file  causes  simscope  to  crash.  A  typical  case  is  that  a  number  like  'OjOOOe-?*  is 
given  as  *0.  e-7*.  simscope  recognizes  the  first  format  only.  The  behaviour  file  can  be 
mended  easily  by  using  an  editor  to  globally  replace  '.  e'  by  'JOOOe*. 

These  bugs  will  be  removed  with  the  next  release  of  simscope. 


AUTHOR 

Rudolf  W.  Nottrott  (UW/NW  VLSI  CONSORTIUM) 
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NAME 

spcpp  -  Spice  (circuit  simulator)  input  pre-processor 
SYNOPSIS 

■pcpp  [-c]  [-tn]  [-d/r]  [-t  rname]  [-«  oname]  iname 
DESCRIPTION 

Spcpp  is  a  program  that  translates  bracketed  text  tokens  in  an  input  file  into  other  text  strings. 
It  is  intended  to  allow  users  of  spice  to  prepare  their  simulation  input  using  mnemonic  node 
names  rather  than  the  numeric  node  numbers  required  by  Spice  commands.  The  program  has 
two  major  modes  of  operation.  If  the  user  does  not  specify  a  file  that  contains  a  translation 
table,  then  spcpp  builds  a  translation  table  itself  numbering  the  tokens  from  zero  as  it 
encounters  them.  Alternatively,  the  user  can  specify  the  name  of  a  file  containing  a  transla¬ 
tion  table  to  be  used.  In  particular,  the  mamea  file  created  by  simZspice  is  usable  as  a  transla¬ 
tion  table  file. 

The  options  and  parameters  are: 

-c  Indicates  that  the  first  non-white^ace  word  of  each  line  of  the  translation  table  file 

should  be  skipped  over.  This  is  useful  if  your  translation  table  has  an  asterisk  (’•’) 
in  column  1  of  each  line  to  allow  it  to  be  read  by  spice  as  comments. 

-sff  Indicates  that  n  lines  at  the  beginning  of  the  translation  table  file  should  be  skipped 
over.  If  no  number  is  specified  then  only  the  first  line  of  the  file  is  skipped. 

-d  Ir  Redefines  the  token  delimiters  to  be  T  and  V*  respectively.  The  default  delimiters 
are  ’<  ’  and  ’>  *. 

-t  tname  Specifies  a  file  that  contains  a  translation  table  (default  is  to  build  a  translation 
table  as  described  above).  Each  line  of  this  file  should  have  at  least  two  non¬ 
whitespace  words  on  it.  If  the  -c  option  is  specified  then  the  first  word  on  each 
line  is  ignored.  The  next  word  is  interpreted  as  a  string  to  be  translated  and  follow¬ 
ing  one  is  interpreted  as  the  target  string  into  which  it  is  translated.  Any  subse¬ 
quent  words  on  the  line  are  ignored.  For  Spice  input  preparation  the  target  string 
should  be  a  numeral.  The  -•  option  allows  the  file  to  be  prefaced  by  one  or  more 
lines  that  spcpp  will  ignore. 

-o  oname  Specifies  a  file  into  which  the  output  is  to  be  written.  If  this  option  is  not  used 
then  the  output  is  written  to  irootjpa  where  iroos  is  obtained  by  stripping  away 
any  tags  from  iname. 

iname  Specifies  the  name  of  the  file  to  process. 

A  bracketed  token  is  defined  to  be  a  left  delimiter  character,  zero  or  more  spaces,  a  word  (the 
token)  not  containing  either  right  or  left  delimiters,  zero  or  more  spaces,  and  a  right  delimiter 
character.  Unmatched  delimiter  characters  are  not  allowed  in  any  context.  Bracketed  tokens 
are  not  allowed  to  span  lines.  Tokens  and  the  strings  that  they  translate  into  are  limited  to  be 
at  most  40  characters  each. 

Any  line  that  contains  no  bracketed  tokens  is  simply  copied  from  the  input  to  the  output.  If  a 
line  does  contain  a  bracketed  token  then  the  input  line  is  written  into  the  output  a  Spice  com¬ 
ment  line.  An  output  line  follows  immediately.  If  the  line  is  valid,  then  the  output  line  has 
the  untranslated  parts  immediately  below  the  corresponding  parts  of  the  commented  input 
line  with  the  target  strings  substituted  for  the  bracketed  tokens.  If  an  error  is  detected,  then 
the  output  line  has  a  caret  (’*’)  immediately  below  the  point  at  which  the  first  error  is 
detected.  An  error  message  line  then  follows.  Since  the  scanning  of  the  line  is  abandoned 
there  may  be  subsequent  undetected  errors  in  the  remaining  part  of  the  tine. 
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Example: 

If  the  following  lines  are  contained  in  the  translation  table  file: 

Vdd  1 
Input  55 
Output  107 
foo  23 
bar  4S 

then  tpcpp  will,  upon  seeing  the  lines: 

^lot  trans  v(<  Input>  )  v(<  Output>  ),  i(<  Vdd>  ) 

+  v(<  foo>  ),  v(<  baf>  ) 

will  output  the  lines: 

•  .plot  trans  v(<  Input>  )  v(<  Output>  )  v(<  Vdd>  ) 

.plot  trans  v(55)  v(107)  v(l) 

•  +  v(<  foo>  ),  v(<  bar>  ) 

+  v(23).  v(45) 

Note  that  spcpp  correctly  handles  Spice  continuation  cards. 

Note  also  that  the  substitution  process  is  not  recursive.  That  is,  once  a  token  has  been 
translated,  the  translated  string  is  not  rescanned. 

The  usefulness  of  spcpp  for  simulating  a  circuit  extracted  from  a  layout  depends  upon  the  user 
being  able  to  ensure  that  his  mnemonic  node  labels  will  be  retained  through  the  extraction 
process.  The  mextra  and  sim2spice  manual  entries  will  help  with  this. 

Pspice  is  a  shell  script  that  runs  sim2spice  and  spcpp  and  concatenates  several  files  is  useful  for 
preparing  Spice  inputs  from  jim  files. 


FILES 

iname 

irootjsjxx 

oname 

tname 

SEE  ALSO 

mextra(l.vlsi),  pspice(l.vlsi),  sim2spice(l.vlsi},  simtools(l.vlsi),  spice(l.vlsi), 

SPICE  User's  Guide,  VLSI  Design  Tools  Reference  Mannal,  UW/NW  VLSI  Consortium, 
University  of  Washington,  (SPICE  Version  2G6  User’s  Guide,  A.  Vladimirescu  et  a!.,  IS 
October  1980) 

AUTHOR 

Robert  Fowler  (UW/NW  VLSI  Consortium,  University  of  Washington) 

DIAGNOSnCS 

The  error  messages  are  intended  to  be  self  explanatory.  If  spcpp  encounters  a  syntax  error  on 
a  line  then  it  suspends  processing  on  that  line  and  writes  it  as  a  Spice  comment  to  the  output 
file.  It  then  writes  a  line  containing  a  caret  (’*’)  under  the  character  at  which  scanning  failed 
and  finally,  a  line  containing  an  error  message.  It  then  goes  on  to  process  the  remaining  lines 
of  the  file.  If  errors  have  been  encountered  then  at  the  end  of  the  output  file  spcpp  writes 
messages  to  the  effect  that  errors  have  been  encountered  and  exits  with  status  1.  Tlie  error 
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messages  written  to  the  output  file  begin  with  dollar  signs.  In  addition,  some  number  of  mes¬ 
sages  are  directed  towards  the  standard  error  output. 

BUGS 

The  target  strings  are  not  checked  to  see  whether  they  are  valid  numerals  or  not.  This  can  be 
regarded  as  either  a  bug  or  a  feature. 

The  target  string  must  fit  into  the  space  from  the  left  to  right  token  delimiter  inclusive.  This 
is  normally  not  a  problem  since  most  node  numbers  will  be  small  integers  and  the  available 
space  will  be  at  least  three  characters.  This  was  done  so  that  the  input  lines  and  the 
translated  outputs  would  line  up  vertically. 
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NAME 

spice  -  circuit  simulator 
SYNOPSIS 

Spice  iitfile  outfile  [m$pfile\ 

DESCRIPTION 

Spice  reads  a  circuit  description  from  it^ile.  Output  is  written  to  outfile.  and  error  messages  to 
standard  error.  An  optional  output  file,  tntpfUe,  can  be  used  by  mtp  to  obtain  a  multiple  time 
series  plot  on  a  Printronix. 

Spice  calls  spice2g6,  a  general-purpose  circuit  simulation  program  for  nonlinear  DC,  nonlinear 
transient,  and  linear  AC  analyses.  Circuits  may  contain  resistors,  capacitors,  inductors, 
mutual  inductors,  independent  voltage  and  current  sources,  four  types  of  dependent  sources, 
transmission  lines,  and  the  four  most  common  semiconductor  devices:  diodes,  BJTs,  JFETs, 
and  MOSFETs. 

Spice2g6  has  built-in  models  for  the  semiconductor  devices,  and  the  user  need  specify  only  the 
pertinent  model  parameter  values.  The  model  for  the  BJT  is  based  on  the  integral  charge 
model  of  Gummel  and  Poon;  however,  if  the  Gummel-Poon  parameters  are  not  specified,  the 
model  reduces  to  the  simpler  Ebers-Moll  model.  In  either  case,  charge  storage  effects,  ohmic 
resistances,  and  a  current-dependent  output  conductance  may  be  included.  The  diode  model 
can  be  used  for  either  junction  diodes  or  Schottky  barrier  diodes.  The  JFET  model  is  based 
on  the  FET  model  of  Shichman  and  Hodges.  Three  MOSFET  models  are  implemented;  MOSl 
is  described  by  a  square-law  I-V  characteristic,  MOS2  is  an  analytical  model  while  MOSS  is  a 
semi-empirical  model.  Both  MOS2  and  MOSS  include  second-order  effects  such  as  channel 
length  modulation,  subthreshold  conduction,  scattering  limited  velocity  saturation,  small  size 
effects  and  charge-controlled  capacitances. 

To  build  a  Spice  input  file  for  your  circuit  from  mextra  output  run  sim2spice  or  pspice. 

SEE  ALSO 

mextra(l.vlsi) 

mtp(l.vlsi),  sim2spice(l.vlsi),  pspice(l.visi),  spcpp(l.vlsi) 

SPICE  User's  Guide.  VLSI  Design  Tools  Rercrcncc  Manoal,  UW/NW  VLSI  Consortium, 
University  '  Washington,  {SPICE  Version  2C6  User’s  Guide,  A.  Vladimirescu  et  al.,  15 
October  I9bv;^. 

Program  Reference  for  Spice2.  E.  Cohen,  ERL  Memo.  ERL-M592,  Electronics  Research 
Laboratory,  University  of  California,  Berkeley,  June  1976. 

SPICE2:  A  Computer  Program  to  Simulate  Semiconductor  Circuits,  L.W.  Nagel,  ERL  Memo. 
ERL-MS20,  Electronics  Research  Laboratory,  University  of  California,  Berkeley,  May  1975. 

The  Simulation  of  UOS  Integrated  Circuit  Using  SPICE2  A.  Vladimirescu  and  Sally  Liu, 
UCB/ERL  M80/7,  University  of  California,  Berkeley,  February  1980. 

AUTHOR 

(UCB) 

BUGS 

MOSFET  Model,  Level=2  does  not  work,  due  to  a  charge  conservation  problem  (it  grows). 


UW/NW  VLSI  Release  2 


1 


10/1/83 


1 


•J 

s 

i 

I 

U 

£l 

v' 

,1 

V 

C 


h*  *>  •• 

%m,mi 


TPL A  ( CADI )  UNUC  Programmer’s  MauuaJ  TPL A  ( CAD  1 ) 


NAME 

tpla  -  technology  independent  PLA  generator 
SYNOPSIS 

tpin  [-acv]  [-S  style\  [-o  output  JUe\  input  JUe 
DESCRIPTION 

Tpla  is  a  PLA  generator  that  generates  PLAs  in  several  different  styles  and  technologies.  The 
input  format  is  compatible  with  eqntott.  see  PLA(S)  for  details.  Tpla  does  not  handle  q}lit  and 
folded  PLAs. 

Tpla  is  a  program  written  with  the  Tpack  system. 

STYLES  OF  PLAs  AVAILABLE 

The  following  styles  of  PLAs  are  currently  supported: 

Bela  Buried  contacts,  nMOS,  cis  version  (inputs  and  outputs  on  same  side  of  the 
PLA).  Clocked  inputs  and  outputs  are  supported.  Berkeley  design  rules. 

Btrans  Buried  contacts,  nMOS,  trans  vernon  (inputs  and  outputs  on  opposite  sides  of 
the  PLA).  Clocked  inputs  and  outputs  are  supported.  Berkeley  design  rules. 

Mels  Mead  &  Conway  design  rules.  Butting  contacts,  nMOS,  cis  versicn  (inputs  and 
outputs  on  same  side  of  the  PLA).  Clocked  inputs  and  outputs  are  supported. 

Mtraas  Mead  &  Conway  design  rules.  Butting  contacts,  nMOS,  trans  version  (inputs 
and  outputs  on  opposite  sides  of  the  PLA).  Clocked  inputs  and  outputs  are 
supported. 

Tela  Just  like  Bela  except  that  it  has  protection  frames  and  terminals  added  (a  spe¬ 
cial  mod  for  EECS  at  Berkeley). 

Ttrana  Just  like  Btrans  except  that  it  has  protection  frames  and  terminals  added, 
laocmoa 

Complies  with  GTE  S  micron,  isoemos  process  (lambda  -  2.5  microns).  Inputs 
and  outputs  on  same  side  of  PLA.  Fabricated  and  tested. 

CS3cls  Complies  with  MOSIS  3  micron  bulk  CMOS  process  (lambda  =  1.0  microns). 
Berkeley  design,  simulated  but  not  fabricated.  Inputs  and  outputs  on  same  side 
of  the  PLA. 

CSJtraa 

Same  as  CS3cls  except  inputs  and  outputs  on  opposite  sides  of  the  PLA. 

It  is  easy  to  create  a  template  for  a  new  style  of  PLA,  and  tpIa(CADS)  has  informa¬ 
tion  on  how  to  do  it.  If  you  develop  a  particularly  nice  template  and  would  like  to 
share  it,  send  it  to  'mayo@berkeley*  or  'ucbvaxtaiayo'’. 

Tpla  handles  CIF  symbol  naming  directives  and  input  &  output  labels  as  described  in 
pla(CADS). 

OPTIONS 

•I  Clock  the  inputs  to  the  PLA,  if  this  feature  is  suppo.-ted  for  this  style. 

•O  Clock  the  outputs  to  the  PLA,  if  this  feature  is  supported  for  this  style. 

•G  nwH  Insert  an  extra  ground  line  every  num  rows  in  the  AND  plane  and  every  num  columns 
in  the  OR  plane. 

•S  num  Stretch  power  and  ground  lines  by  rimi  lambda. 

-T  Be  verbose,  and  show  (in  the  Caesar  output)  how  the  PLA  was  constructed  from  its 
basic  components. 
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•V  Be  verbose,  and  print  out  information  about  what  tpla  is  doing.  This  option  implies 

•a  produce  Caesar  format  (this  is  the  default) 

•c  produce  CIF  format 

•o  The  next  argument  is  taken  to  be  the  base  name  of  the  output  file.  The  default  is  the 
input  file  name  with  any  extensions  removed.  If  the  input  comes  from  the  standard 
input  and  the  -o  option  is  not  q>ecified  then  the  output  will  go  to  the  standard  output. 

•s  The  next  argument  specifies  the  style  of  PLA  to  generate.  (This  causes  tpla  to  use  the 
file  'cad/Ub/tpla/p*iiy/e.tp  as  its  template). 

•I  niim  Set  lambda  to  mm  centimicrons.  (200  is  the  default) 

•t  The  next  argument  qjecifies  the  template  to  use,  this  normally  defaults  to  the  standard 
library.  A  4p  suffix  is  added  if  no  suffix  was  specified.  This  option  is  useful  for  gen* 
crating  styles  of  PLAs  that  are  not  included  in  the  standard  library. 

inpef _fUe 

The  file  containing  the  truthjable.  If  this  filename  is  omitted  then  the  input  is  taken 
from  the  standard  input  (such  as  a  pipe). 

other  options 

This  program  inherits  several  more  options  from  Tpack(CAD). 

FILES 

'cad/bin/tpla  **  executable 

'cad/src/tpla/*  -  source 

*cad/lib/tpla/p*.«p  ••  standard  templates  for  PLAs 

SEE  ALSO 

eqntott(CAD),  presto(CAD),  plasort(CAD),  pIa(CADS),  tpIa(CADS),  tp8ck(CAD), 
mkpla(CAD) 

AUTHOR 

Robert  N.  Mayo 

BUGS 

The  defaults  for  the  -G  and  •$  options  have  no  way  of  knowing  what  the  grounding  require¬ 
ments  are  for  the  style  of  PLA  actually  being  generated. 

If  the  template  CS3cis  or  CSStran  is  used  with  an  odd  number  of  minterms  and  the  -G  option 
is  used,  there  will  be  design  rule  violations;  extra  pieces  of  P-t*  implant  along  the  bottom  of 
the  OR  plane,  which  will  have  to  be  manually  removed. 

The  templates  Tcis  and  Ttrans  imply  a  technology  (fnmos)  not  supplied  on  the  Berkeley  tape. 
These  templates  will  not  be  useful  unless  the  associated  technology  files  are  obtained. 

This  program  inherits  any  bugs  that  may  exist  in  tpack(CAD). 
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NAME 

vie  -  view  an  integrated  circuit  layout  (version  2.1). 

SYNOPSIS 

vie  [options]  symbolname 
DESCRIPTION 

Vic  is  an  interactive  graphics  display  program  for  integrated  circuits  that  is  technology 
independent  and  has  a  built-in  hardcopy  feature.  It  understands  layouts  in  Caesar  data  base 
format.  It  currently  displays  only  on  the  GP19  and  Tek410S  graphics  terminals,  but  it  can  pro¬ 
duce  a  hardcopy  on  a  number  of  devices. 

The  t^tioHS  are  as  follows: 

-t  technology 

Supported  values  of  technology  are  nmos  and  emos-pw.  Default  is  cm«M>pw. 

-h  plotter 

Supported  values  for  plotter  are  HP7221CT,  HP7221AB,  HP75S0,  HP7580B  and 
Tek4M2_31.  Default  u  HP7580. 

-t  graphics 

Supported  values  for  graphics  are  GP19  and  Tck4105.  Default  is  GP19. 

-{format 

The  only  Choice  (or  format  of  symbol  to  be  read  is  ca  (Caesar  files). 

CObfMANDE 

For  all  the  commands,  only  the  portion  enclosed  in  parentheses  need  be  typed  and  a  list  of  the 
possible  parameters  for  each  command  (if  any)  and  current  values  are  shown  after  the  com¬ 
mand  in  the  menu. 

(lay)crs  <  llst> 

sets  the  layers  to  be  plotted.  The  list  consists  of  layer  names  seperated  by  q>aces,  or 
the  entire  list  may  be  preceded  by  a  *-<-*.  In  the  latter  case,  the  given  layers  are  added 
to  the  plot  ALREADY  on  the  screen  (it  should  be  pointed  out  that  a  space  most  fol¬ 
low  immediately  after  the  *->-*,  followed  by  the  additional  layers).  A  null  list  sets  all 
layers  to  be  plotted.  Abbreviations  are  allowed.  The  first  layer  with  the  abbreviation 
as  its  leading  part  will  be  selected.  (Thus,  metal  can  be  abbreviated  m,  me,  met  or 
meta,  whereas  metal2  will  require  the  entire  name.  Warning:  layer  names  such  as 
metal2  and  cut2  must,  therefore,  follow  metal  and  cut,  respectively  in  the  technology 
files.)  Default  is  all  layers. 

(■)csttag  Unit  <  ■ambcr> 

set  the  number  of  levels  in  the  symbol’s  hierarchy  to  be  plotted.  Any  symbol  at  a  level 
greater  than  this  will  show  up  only  as  a  bounding  box  with  its  symbol  name  in  the 
lower  left  comer.  The  current  symbol  is  at  level  1,  its  children  are  at  level  2,  and  so 
on.  Default  is  1. 

(w)ladow 

window  in  on  the  plot.  Use  the  graphics  cursor  to  move  to  the  desired  lower  left 
comer  of  the  window  and  hit  the  q>ace  bar.  Then  move  to  the  upper  right  comer  and 
do  the  same. 

(hard)copy 

produce  a  hardcopy  of  exactly  what  is  shown  on  the  terminal  screen  on  a  pen  plotter. 
A  grid  may  be  plaeed  over  the  hardcopy  by  specifying  anything  greater  than  zero 
when  the  program  prompts  for  grid  size.  For  this  option  to  work,  the  user’s  terminal 
must  communicate  with  the  host  through  the  plotter,  in  order  that  the  plotter  may 
intercept  the  plotting  commands.  For  the  Tek410S,  the  grid  must  be  displayed  prior  to 
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hard  copying. 

(Iab)cia  <  Talac> 

turn  node  labels  on/off.  Default  is  on. 

(p) lot  plot  on  the  graphics  terminal  with  the  current  options  in  effect. 

(v)lcw  view  on  the  graphics  terminal  the  current  symbol  fully  instantiated  with  all  layers  and 
node  labels. 

(g)raphlcs 

return  to  the  graphics  screen  (Tek4105  only). 

(■rl)d  put  a  grid  on  the  graphics  screen  (Tek410S  only). 

(hc)lp  show  the  menu. 

(c)aplain 

explain  each  command. 

(q) alt  quit  from  the  program. 

(slymbol  <  uaniO 

select  the  symbol  to  be  plotted.  The  only  symbols  that  can  be  specified  are  those  in 
the  sub-hierarchy  of  the  top  level  qrmbol  on  the  command  line.  Note  that  this  is  not  a 
facility  to  reinitialize  the  vie  with  a  new  symbol.  Executing  this  command  with  no 
name  causes  the  list  of  symbols  to  be  displayed.  Default  is  the  highest  level  symbol. 

<cantrol>  C 

causes  current  operation  in  progress  to  cease.  On  the  Tek410S,  to  terminate  a  hard¬ 
copy  in  progress,  depress  the  <  shift>  cancel  key  on  the  keyboard  and  type  a  carriage 
return. 

DIAGNOSTICS 

If  an  error  occurs,  a  message  is  written  to  standard  error  and  the  program  exits  with  a  non¬ 
zero  status. 

nLES 

technology. Xcq2 
technology  Atop 
symboLaXt 
symboLci 

SEE  ALSO 

caesar(CADl),  tec(S.vIsi) 

AUTHOBS 

Pat  Bates 
Larry  McMurchie 
Wayne  E.  Winder 
Bruce  A.  Yanagida 
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NAME 

caesar  -  VLSI  circuit  editor 
SYNOPSIS 

caanr  [  -b  -g  graphics_port  -t  tabtet_port  -p  path  -m  monitor.type  -d  display_type  ]  [  file  ] 
DESCSIPTION 

Cottar  is  an  interactive  system  for  editing  VLSI  circuits  at  the  level  of  mask  geometries.  It 
uses  a  variety  of  color  displays  with  a  bit  pad  as  well  as  a  standard  text  terminal.  For  a  com¬ 
plete  description  and  tutorial  introduction,  see  the  user  manual  'Editing  VLSI  Circuits  with 
Caesar*  (an  on-line  copy  is  in  'cad/doc/caesariblms). 

Command  line  switches  are: 

-B  Execute  in  non-interactive  mode. 

-g  The  next  argument  is  the  name  of  the  port  to  use  for  communication  with  the  graph¬ 
ics  display.  If  not  specified,  Caesar  makes  an  educated  guess  based  on  the  terminal 
from  which  it  is  being  run. 

-t  The  next  argument  is  the  name  of  the  port  to  use  for  reading  information  from  the 
graphics  tablet.  If  not  specified,  Caesar  makes  an  educated  guess  (usually  the  graphics 
port). 

-p  The  next  argument  is  a  search  path  to  be  used  when  opening  files. 

-m  The  next  argument  is  the  type  of  color  monitor  being  used,  and  is  used  to  select  the 

right  color  map  for  the  monitor's  phosphors.  ”std*  works  well  for  most  monitors, 
'pale'  is  for  monitors  with  especially  pale  blue  phosphor. 

-d  The  next  argument  is  the  type  of  display  controller  being  used.  Among  the  display 
types  currently  understood  are:  AED512,  UCBS12  (the  AED512  with  special  Berkeley 
PROMs  for  stippling),  AED767,  AED640  (an  AED767  configured  as  483x640  pixels), 
Omega440,  R9400,  or  Vectrix. 

When  Caesar  starts  up  it  looks  for  a  command  file  with  the  name  'xaesat*  in  the  home  direc¬ 
tory  and  processes  it  if  it  exists.  Then  Caesar  looks  for  a  xaesar  file  in  the  current  directory 
and  reads  it  as  a  command  file  if  it  exists.  The  xaesar  file  format  is  described  under  the  long 
command  source. 

You  generally  have  to  log  in  a  job  on  the  color  terminal  under  the  name  'sleeper*  (no  pass¬ 
word  required).  This  is  necessary  in  order  for  the  tablet  to  be  useable.  Sleeper  can  be  killed 
either  by  typing  two  control-backslashes  in  quick  succession  on  the  color  display  keyboard  (on 
the  AED  displays,  control-backslash  is  gotten  by  typing  control-shift-L),  or  by  invoking  the 
shell  conunand  kUtsleeper  with  the  correct  process  id.  On  some  systems  you  have  to  log  your¬ 
self  in  and  run  sleeper  as  a  shell  command.  On  still  other  systems  there  is  no  login  process  for 
the  color  display  port,  so  it  isn’t  necessary  to  run  sleeper  at  all. 

The  four  buttons  on  the  graphics  tablet  puck  are  used  in  the  following  way: 
left  (white) 

Move  the  box  so  that  its  fixed  comer  (normally  lower-left)  coincides  with  the  crosshair 
position. 

right  (grccB) 

Move  the  box’s  variable  comer  (normally  upper-right)  to  coincide  with  the  crosshair 
position.  The  fixed  comer  is  not  moved. 

top  (yellow) 

Find  the  cell  containing  the  crosshair  whose  lower-left  comer  is  closest  to  the 
crosshair.  Make  that  cell  the  current  cell.  If  the  button  is  depressed  again  without 
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moving  the  crosshair,  the  parent  of  the  current  cell  is  made  the  current  cell. 

bottoa(blne) 

Paint  the  area  of  the  bos  with  the  mask  layers  underneath  the  crosshair.  If  there  are 
no  mask  layers  visible  underneath  the  crosshair,  erase  the  area  of  the  bos. 

SHOKT  COMMANDS 

Short  commands  are  invoked  by  typing  a  single  letter  on  the  keyboard.  Valid  commands  are: 

a  Yank  the  information  underneath  the  box  into  the  yank  buffer.  Only  yank  the  mask 
layers  present  under  the  crosshair  (if  there  are  no  mask  layers  underneath  the 
crosshair,  yank  all  mask  layers  and  labels). 

e  Uneiqiand  current  cell  (display  in  bounding  box  form). 

d  Delete  paint  underneath  the  box  in  the  mask  layers  underneath  the  crosshair  (if  there 
are  no  mask  layers  underneath  the  crosshair,  the  delete  labels  and  all  mask  layers). 

a  Move  the  box  up  1  lambda. 

I  Toggle  grid  on/off. 

1  Redisplay  the  information  on  both  text  and  graphics  screens, 
q  Move  the  box  left  1  lambda, 

r  Move  the  box  down  1  lambda. 

s  Put  back  (stuff)  all  the  information  in  the  yank  buffer  at  the  current  box  location. 

Stuff  only  information  in  mask  layers  that  are  present  underneath  the  crosshair  (if 
there  are  no  mask  layers  underneath  the  crosshair,  stuff  all  mask  layers  plus  labels). 

n  Undo  the  last  change  to  the  layout, 

w  Move  the  box  right  one  lambda. 

s  Unexpand  all  cells  that  intersect  the  box  but  don’t  contain  it. 
a  Zoom  in  so  that  the  area  underneath  the  box  fills  the  screen. 

C  Expand  current  cell  so  that  its  paint  and  children  can  be  seen. 

X  Expand  all  cells  that  intersect  the  box,  recursively,  until  there  are  no  unexpanded  cells 

intersecting  the  box. 

Z  Zoom  out  so  that  everything  on  current  screen  fills  the  area  underneath  the  box. 

S  Move  the  picture  so  that  the  fixed  comer  of  the  box  is  in  the  center  of  the  screen, 

i  Move  the  picture  so  that  the  variable  comer  of  the  box  is  in  the  center  of  the  screen. 

*L  Redisplay  the  graphics  and  text  di^lays. 

Repeat  the  last  long  command. 

LONG  COMMANDS 

Long  commands  are  invoked  by  typing  a  colon  character  ('.').  The  cursor  will  appear  on  the 
bottom  line  of  the  text  terminal.  A  line  containing  a  command  name  and  parameters  should 
be  typed,  terminated  by  return.  Each  line  may  consist  of  multiple  commands  separated  by 
semi>colons  (to  use  a  colon  as  part  of  a  long  command,  precede  it  with  a  backsla^).  Short 
commands  may  be  invoked  in  long  command  format  by  preceding  the  short  command  letter 
with  a  single  quote.  Unambiguous  abbreviations  for  command  names  and  parameters  are 
accepted.  The  commands  are: 
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align  <  Kale> 

Change  crosshair  alignment  to  <scale>.  Crosshair  pontion  will  be  rounded  off  to 
nearest  multiple  of  <  scale> . 

array  <  nlaa>  <  ysisc> 

Make  the  current  cell  into  an  array  with  <xsize>  instances  in  the  x-direction  and 

<  ysize>  instances  in  the  y-direction.  The  spacing  between  elements  is  determined  by 
the  box  X*  and  y-dimensions. 

array  <  xbet>  <  ybot>  <  xtop>  <  ytop> 

Make  the  current  cell  into  an  array,  numbered  from  <xbot>  to  <xtop>  in  the  x- 
direction  and  from  <ybot>  to  <ytop>  in  the  y-direction.  The  spacing  between 
array  elements  is  determined  by  the  box  x-  and  y-dimensions. 

box  <keyword>  <amoant> 

Change  the  box  by  <amount>  lambda  units,  according  to  <keyword>.  If  <key- 
word>  is  one  of  'left*,  'right*,  'up*,  or  'down',  the  whole  box  is  moved  the  indicated 
amount  in  the  indicated  direction.  If  <  keyword>  is  one  of  'xbot',  'ybot*,  'xtop*.  or 
*ytop*,  then  one  of  the  coordinates  of  the  box  is  adjusted  by  the  given  amount. 

<  amount>  may  be  either  positive  or  negative. 

button  <  nanibcr>  <  x>  <  y> 

Simulate  the  pressing  of  button  <  number>  at  the  screen  location  given  by  <  x>  and 
<y>  (in  pixels).  If  <x>  and  <y>  are  omitted,  the  current  crosshair  position  is 
used. 

elf  -ships  <  nama>  <  aeale> 

Write  out  a  CDF  description  of  the  layout  into  file  <  name>  (use  edit  cell  name  by 
default;  a  *xir  extensiou  a  supplied  by  default).  <scale>  indicates  how  many  cen- 
timicrons  to  use  per  Caesar  unit  (200  by  default).  The  -s  switch  causes  no  silicon 
(paint)  to  be  output  to  the  CCF  file.  The  -b  switch  causes  bounding  boxes  to  be  drawn 
for  unexpanded  cells.  The  -I  causes  labels  to  be  output.  The  -p  switch  causes  a  CIF 
point  to  be  generated  for  each  label.  The  -x  switch  causes  Caesar  not  to  automatically 
expand  all  cells  (they  are  expanded  by  default). 

dead  <fllc> 

Load  the  colormap  from  <  file> .  The  monitor  type  is  used  as  default  extension, 
clockwise  <degrees>  [y] 

Rotate  the  current  cell  by  the  largest  multiple  of  90  degrees  less  than  or  equal  to 

<  degrees> .  <  degrees>  defaults  to  90.  If  the  command  is  followed  by  a  *y*  then  the 
yank  buffer  is  rotated  instead  of  the  current  cell. 

colormap  <layerB> 

Print  out  the  red,  green,  and  blue  intensities  associated  with  <  layers> . 

colormap  <  layers>  <  rcd>  <  grecB>  <  blac> 

Set  the  intensities  associated  with  <  l8yers>  to  the  given  values. 

copycell 

Make  a  copy  of  the  current  cell,  and  position  it  so  that  its  lower-left  comer  coincides 
with  the  lower-left  comer  of  the  box. 

esavt  <  fllo 

Save  the  current  colormap  in  <  file>  (the  monitor  type  is  used  as  default  extension). 

dclttcccll 

Delete  the  current  cell, 
cditccu  <  nio 

Edit  the  cell  hierarchy  rooted  at  <file>.  A  *xa*  extension  is  supplied  by  default.  If 
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information  in  the  current  hierarchy  has  changed,  you  are  given  a  chance  to  write  it 
out. 

craaapalBt  <layara> 

For  the  area  enclosed  by  the  box.  erase  all  paint  in  <  layers> .  If  <  layers>  is  omitted 
it  defaults  to  *«l*. 

fill  < dlr«etloa>  <l«ycn> 

<  direction>  is  one  of  *left*,  “ri^t*.  *up*,  or  ”down*.  The  paint  under  one  edge  of 
the  box  (req)ectively,  the  right,  left,  bottom,  or  top  edge)  is  sampled;  everywhere  that 
the  edge  touches  paint,  the  paint  is  extended  in  the  given  direction  to  the  opposite 
side  of  the  box.  <  iayers>  selects  which  layers  to  fill;  if  omitted  then  a  default  of  '•<* 
is  used. 

flashcell 

Remove  the  definition  of  the  current  definition  from  main  memory  and  reload  it  from 
the  disk  version.  Any  changes  to  the  cell  since  it  was  last  written  are  lost. 

gcteell  <  flla> 

This  command  makes  an  instance  of  the  cell  in  <  file>  (a  'ca*  extension  is  supplied 
by  default)  and  positions  that  instance  at  the  current  box  location.  The  box  size  is 
changed  to  equal  the  bounding  box  of  the  cell. 

grldapactng 

The  grid  is  modified  so  that  its  spacings  in  x  and  y  equal  the  dimensions  of  the  box. 
The  grid  is  set  so  that  the  box  falls  on  grid  points. 

gripe  The  mail  program  is  run  so  that  comments  can  be  sent  to  the  Caesar  maintainer. 

height  <  slsc> 

The  box’s  height  is  set  to  <  size> .  If  <  si2e>  is  preceded  by  a  plus  sign  then  the  fixed 
comer  is  moved  to  set  the  correct  height;  otherwise  the  variable  comer  is  moved. 

<  size>  defaults  to  2. 

Mcntirycell  <  aamc> 

The  current  cell  is  tagged  with  the  instance  name  given  by  <  name> .  This  feature  is 
not  currently  supported  in  any  useful  fashion.  <  name>  may  not  contain  any  white 
space. 

label  <  namO  <  poslttoa> 

A  rectangular  label  is  placed  at  the  box  location  and  tagged  with  <  name> .  <  name> 
may  not  contain  any  white  space.  <  position>  is  one  of  'center",  "left",  'right',  'top', 
or  "bottom';  it  specifies  where  the  text  is  to  be  displayed  relative  to  the  rectangle.  If 
omitted,  <  position >  defaults  to  'top'. 

lyra  <  nilMcl> 

The  program  'cad/bin/Iyra  is  ran,  and  is  passed  via  pipe  all  the  mask  features  within 
3k  of  the  box.  The  program  returns  labels  identifying  design  rale  violations,  and  these 
are  added  to  the  edit  cell.  If  <  raleset>  is  specified,  it  is  passed  to  Lyra  with  the  -r 
switch  to  indicate  a  specific  ruleset.  Otherwise,  the  current  technology  is  used  as  the 
raleaet. 

macro  <  charactar>  <  coniaiaad> 

The  given  long  command  is  associated  with  the  given  character,  such  that  whenever 
the  character  is  typed  as  a  short  command  then  the  given  command  is  executed.  This 
overrides  any  existing  definition  for  the  character.  To  clear  a  macro  definition,  type 
'macro  <  character>  ',  and  to  clear  all  macro  definitions,  type  '.macro' 

mark  <  markl>  <  mark2> 

The  box  is  saved  in  the  mark  given  by  <markl>.  <markl>  must  be  a  lower-case 
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letter.  If  <  mark2>  is  specified,  the  box  is  changed  to  coincide  with  <  mark2> . 

movcceU  <  keywonl> 

The  current  cell  is  moved  in  one  of  two  ways,  selected  by  <  keyword> .  If  <  key- 
word>  is  'byposition',  then  the  ceil  is  moved  so  that  its  lower-left  comer  coincides 
with  the  lower-left  comer  of  the  box.  This  also  happens  if  no  keyword  is  specified.  If 

<  keyword>  is  'bysize',  then  the  cell  is  displaced  by  the  size  of  the  box  (this  means 
that  what  used  to  be  at  the  fixed  comer  of  the  box  will  now  be  at  the  variable  comer). 

paint  <  \Myttt> 

The  area  underneath  the  box  is  painted  in  <  layers>  . 

path  <  path> 

The  string  given  by  <path>  becomes  the  search  path  used  during  file  lookups. 

<  path>  consists  of  directory  names  separated  by  colons  or  spaces.  Each  name  should 
end  in  '/'. 

peck  <  laycn> 

Display  all  paint  underneath  the  box  belonging  to  <layers>,  even  for  unexpanded 
celb  and  their  descendants. 

popbax  <  aiarfc> 

If  <mark>  is  specified,  then  the  box  is  replaced  with  the  given  mark.  Otherwise  the 
box  stack  is  popped  and  the  top  stack  element  overwrites  the  box. 

poshbox  <  ■nark> 

The  box  is  pushed  onto  the  box  stack.  If  <mark>  is  specified  then  it  is  used  to 
overwrite  the  box,  otherwise  the  box  remains  unchanged. 

pat  <  layen> 

The  yank  buffer  information  in  <Iayers>  is  copied  back  to  the  box  location.  If 

<  layers>  is  omitted,  it  defaults  to  '«S1'. 

quit  If  any  cells  have  changed  since  they  were  last  saved  on  disk,  the  user  is  given  a  chance 
to  write  them  out  or  abort  the  command.  Otherwise  the  program  returns  to  the  shell. 

reset  The  graphics  display  is  reinitialized  and  the  colormap  is  reloaded. 

retam  The  current  subedit  is  left,  and  the  containing  edit  is  resumed. 

savecell  <  aame> 

If  <  name>  is  specified  then  the  current  cell  is  given  that  name  and  written  to  disk 
under  the  name  (a  *xa*  extension  is  supplied  by  default).  If  <file>  isn’t  specified 
then  the  cell  is  written  out  to  the  disk  file  from  which  it  was  read. 

KroU  <  directlon>  <  aiiioant>  <  anlts> 

The  current  view  is  moved  in  the  indicated  direction  by  the  indicated  amount. 
<direction>  must  be  one  of  'left',  'right',  'up',  or  'down',  <amount>  is  a  floating¬ 
point  number,  and  <units>  is  one  of  'screens'  or  'lambda'.  <units>  defaults  to 
'screens',  and  <  amount>  defaults  to  05. 

scarcb  <rctezp> 

Search  labels  and  bounding  boxes  underneath  the  box  for  text  matching  <  regexp> . 
See  the  manual  entry  for  ed  for  a  description  of  <  regexp> .  Push  an  entry  onto  the 
box  stack  for  each  match.  Even  unexpanded  cells  are  searched. 

sideways  [y) 

Flip  the  current  cell  sideways  (i.e.  about  a  vertical  axis).  If  the  command  is  followed 
by  a  'y*  then  the  yank  buffer  is  flipped  instead  of  the  current  cell. 

soarec  <  fllcaamO 

The  given  file  is  read,  and  each  line  is  processed  as  one  long  command  (no  colons  are 
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necessary).  Any  line  whose  last  character  is  backslash  is  joined  to  the  following  line, 
snbcdlt  Make  the  current  cell  the  edit  cell,  and  edit  it  in  context, 
tcchnolefy  <  fUO 

Load  technology  information  from  <file> .  A  '.tech*  extension  is  supplied  by  default, 
apstdedown  [y] 

Flip  the  current  cell  upside  down.  If  the  command  is  followed  by  a  'y*  then  the  yank 
buffer  is  flipped  instead  of  the  current  cell. 

usage  <  ftle> 

Write  out  in  <file>  the  names  of  all  the  files  containing  cell  definitions  used  any¬ 
where  in  the  design  hierarchy. 

view  <  aiarfc> 

If  <mark>  is  specified,  set  view  to  it,  otherwise,  change  the  view  to  encompass  the 
entire  edit  cell. 

vlstblclayers  <  iayen> 

Set  the  visible  layers  to  include  just  <layers>.  Preface  <layers>  with  a  plus  or 
minus  sign  to  add  to  or  remove  from  the  currently  visible  ones. 

width  <  dxe> 

Set  the  box  width  to  <  size>  (default  is  2).  Move  variable  comer  unless  width  is  pre¬ 
ceded  by  '-t-*,  else  move  fixed  comer. 

wrlteall 

Run  through  interactive  script  to  write  out  all  cells  that  have  been  modified  , 
yank  <  laycn> 

Save  in  the  yank  buffer  all  information  underneath  the  box  in  <  Iayers>  .  <  Iayers> 
defaults  to 

ycdl  <  aamO 

If  <name>  is  specified,  do  the  equivalent  of  'rgetcell  <name>*.  Then  expand 
current  cell,  yank  it,  delete  the  cell,  and  put  back  everything  that  was  yanked.  This 
flattens  the  hierarchy  by  one  level. 

ysava  <  namO 

Save  the  yank  buffer  contents  in  a  cell  named  <  name>  .  A  'xa*  extension  is  provided 
by  default. 


LAYERS 

nMOS  mask  layers  are: 
p  or  r  Polysilicon  (red)  layer, 
d  or  g  Diffusion  (green)  layer. 
m  Metal  (blue)  layer. 

I  or  y  Implant  (yellow)  layer, 
b  Buried  contact  (brown)  layer, 
c  Contact  cut  layer. 

0  Overglass  hole  (gray)  layer. 

a  Error  layer:  used  by  design  rule  checkers  and  other  programs. 
CMOS  P-well  mask  layers  are  (using  technology  cmos-pw): 
p  or  r  Polysilicon  (red)  layer. 
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d  or  t  Diffusion  (green)  layer, 
m  Metal  (blue)  layer, 
e  Contact  cut  layer. 

P  or  y  P-t*  implant  (pale  yellow)  layer, 
w  P-well  (brown  stipple)  layer, 

o  Overglasa  hole  (gray)  layer. 

0  Error  layer:  used  by  design  rule  checkers  and  other  programs. 
Predefined  system  layers  are: 

•  All  mask  layers. 

I  Label  layer. 

S  Subcell  layer. 

C  Cursor  layer. 

G  Grid  layer. 

B  Background  layer. 

SYSTEM  MARKS 

C  The  bounding  box  of  the  current  cell. 

E  The  bounding  box  of  the  edit  cell. 

F  The  previous  view. 

R  The  bounding  box  of  the  root  cell. 

V  The  current  view. 


FILES 

*cad/new/caesar,  'cad/doc/caesar.tblms 

SEE  ALSO 

cif2ca(l) 

AUTHOR 

John  Ousterhout 

BUGS 
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NAME 

cdrc,  cdtcacript,  drc,  drcscript  •  CMOS-BULK  3  micron  and  NMOS  VLSI  design  rule  checkers 
SYNOPSIS 

cdre  [-kn]  bosenamejot 

cdrcacrlpt  basemunexit  drc  [-ka]  basenaiitejdt  [lauMa] 
drcacrlpl  batenamexit 

DESCRIPnON 

Cdre  analyces  a  CMOS  CIF  file  for  geometric  rule  violations  using  MOSIS  cmos-bulk  3  micron 
process  rules.  Dre  analyzes  an  NMOS  CIF  file  for  geometric  rule  violations  using  MOSIS 
(buried  contact)  rules.  Both  edre  and  drc  are  limited  to  rectilinear,  orthogonal  geometry. 
Wires  are  taken  apart  into  rectangles,  and  round  flashes  ate  approximated  by  squares. 
Polygons  and  non-manhattan  rectangles  are  simply  ignored. 

The  options  are  as  follows: 

-k  Keep  around  all  intermediate  files. 

-Q  Keep  around  files  of  unfilteted  error  messages. 

For  large  files,  edre  or  dre  should  be  run  in  batch  mode,  as  a  7000  transistor  chip  takes  over  2 
11/780  cpu  hours. 

When  edre  or  dre  find  violations,  they  create  CIF  files  of  rectangles  marking  the  geometric 
edges  involved.  These  markers  are  placed  on  the  error  layer  (CZ)  for  cdrc  and  on  the  glass 
layer  for  dre.  Separate  files  are  created  for  each  class  of  error,  named  tnxrrortypeJxuename. 

To  abort  edre  or  dre  hit  the  BREAK  key  and  wait  while  it  outputs  some  error  messages  until  it 
eventually  quits. 

{C\dreseript  will  merge  {e}dre  output  files,  labels  indicating  etror  type,  and  the  original  CIF 
file  into  a  single  file,  detbasenamexll.  If  this  file  is  processed  by  eif2ea  the  results  may  be 
viewed  with  eaesar.  Errors  show  up  as  light  blue  boxes  in  the  error  layer  for  edre  or  as 
orange  boxes  in  the  glass  layer  for  dre.  Each  pair  of  boxes  involved  in  an  error  will  have  an 
associated  errortype  label  which  will  be  located  at  the  midpoint  between  the  centers  of  the 
two  boxes. 


MOSIS  CMOS/BULK  3  micron  process  rules  checked  by  edre: 

Errortype 

Microns 

Rule 

wWp 

3 

P'WeU  width 

sWp 

9 

P'Well  to  P-Well  spacing  assuming  all  p-wells  are 
connected  to  vss 

dW 

4 

Diffusion  size 

dS 

4 

P-f  diffusion  to  P-f  diffusion  spacing 

4 

N+  diffusion  to  N-f  diffusion  spacing 

4 

N4-  diffusion  to  P-f  diffusion  spacing  outside  P-well 

4 

N-i-  diffusion  to  P-t-  diffusion  spacing  inside  P-well 

pWp+DS 

8 

P-t-  diffusion  in  N-substrate  to  P-well  edge  spacing 

Wpn+WnS 

7 

N't-  diffusion  in  N-substrate  to  P-wcll  edge  spacing 

pWn+DS 

4 

N't*  diffusion  in  P-well  to  P-well  edge  spacing 

pW 

3 

Pdy  width 

pS 

3 

Poly  to  poly  spacing 

pSd 

2 

Field  poly  to  diffusion  spacing 

pog 

3 

Poly  gate  extension  over  field 

gpSd 

3 

Gate  poly  to  diffusion  spacing 

p+Od 

2 

P-t-  mask  overlap  of  diffusion 

2 

N-t-  mask  to  P-t-  diffusion  spacing 
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Pi 


u 


Tn+S 

35 

P4-  mask  overlap  of  poly  in  diffusion 

p+S 

3 

P+  mask  to  P-t-  mask  spacing  in  diffusion 

3 

N-t-  mask  to  N+  mask  qiacing  in  diffusion 

Errortype 

Microns 

Rule 

Dp+s 

2 

P-t-  mask  to  N-t-  diffusion  spacing 

2 

N-t-  mask  overlap  of  diffusion 

Tp+s 

35 

N-t-  mask  overlap  of  poly  in  diffusion  :  P-t-  mask  to 
poly  spacing  in  diffusion  inside  P-Well 

bcot 

Cut  must  have  metal  and  (poly  or  diffusion)  underneath 

wC 

3 

Contact  width 

cL 

8 

Maximum  contact  length 

cS 

3 

Contact  to  contact  spacing 

pOe 

2 

P<dy  overlap  of  contact 

PMCz 

2^ 

Poly  overlap  of  contact  in  direction  of  metal 

cSpe 

3 

Contact  to  poly  channel  spacing 

mOc 

2 

Metal  overlap  of  contact 

dOc 

2 

Diffusion  overlap  of  contact 

q)+s 

3 

Contact  to  P4-  and  N-f  mask  spacing 

scfp+ 

4 

Shorting  contact  extension  into  P-t-  diffusion 

scfa+ 

4 

Shorting  contact  extension  into  N-l-  diffusion 

mW 

3 

Metal  width 

mS 

4 

Metal  to  metal  qiacing 

m2w 

5 

Metal2  width 

in2S 

5 

Metal2  to  metal2  spacing 

c2w 

3 

Via  width 

c2S 

3 

Via  to  via  spacing 

m20c2 

25 

Met8l2  extension  over  via 

inOc2 

25 

Metal  extension  over  via 

CC28 

3 

Via-cut  separation 

dOv 

3 

Diffusion  overlap  of  via 

dSv 

3 

Diffusion  to  via  spacing  when  they  dont  overlap 

pOv 

3 

P<dy  overlap  oi  via 

pSv 

3 

Poly  to  via  spacing  when  they  dont  overlap 

M2ftt 

1 

MetaI2,  metal  and  poly  intersection  1  width 

MPMM2X 

4 

Metal  extension  over  the  above  intersection 

PPMM2X 

3 

Poly  extension  over  the  above  intersection 

PM2st 

5 

Metal2  metal  intersection(no  poly)  to  metal2  poly 
iotersection(  with  no  metal )  spacing 

MPM2st 

5 

Metal2  poly  intersection  (no  metal)  to  metal  spacing 

PPM2st 

5 

Metal2  metal  intersection  (no  poly)  to  poly  spacing 

rules  checked  by  drc: 

Errortype 

Rule 

Lambda 

dS 

diffusion  spacing  3j0 

iOg 

implant-gate  overlap  1 J 

iSg 

implant-gate  spacing  2D 

ps 

poly  spacing 

2D 

pOg 

poly-gate  overlap  2D 

pSd 

poly-diff  spacing  ijO 

cS 

cut-cut  spacing 

2D 

dcSg 

diff-cut  to  gate 

2D 

mW 

metal  width 

3D 

iNOg 

implants  with  no  gates 
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xc 

cuts  with  no  D  or  P 

dW 

diffusion  width 

2j0 

ntdW 

non-xtr  diff  width 

2j0 

iS 

implant-implant 

1.S 

pW 

poly  width 

2J) 

gw 

gate  width 

2j0 

cW 

cut  min  width 

2j0 

cL 

cut  max  length 

6i> 

mOc 

metal-cut  overlap 

IjO 

dOc 

diff-cut  overlap 

li) 

pOc 

poly-cut  overlap 

IJD 

sBP 

buried-poly  spacing 

2J) 

sBD 

buried-diffusion  spacing 

2J0 

oBD 

buried-diffusiofl  overlap 

2J) 

oBU 

buried-contact  surround 

UO 

bW 

buried-cootact  width 

2J> 

SEE  ALSO 

caesar(cadl),  cif2c8(cadl) 

A  Geomttrie  Design  Ride  Checker,  Dorothea  Haken,  VLSI  Document  VOSS.  Carnegie  Mellon,  9 
June  1980. 

nLES 

baseHame.eif 

tnerrortypehasename 

dtebasenamejat 

mbasenameeit 

AUTHOR 

Dorothea  Haken  (CMU) 

BUGS 

The  poly-overlap-gate  check  fails  when  the  overlap  is  exactly  zero  {drc  only). 

Spacing  checks  do  not  consider  mutual  connectivity.  Sometimes  weird  things  will  happen,  and 
the  generated  spurious  errors  can  be  filtered  by  the  bin_filter  program,  which  examines  local 
connectivity.  Cuts  in  diffusion  or  poly  that  do  not  have  metal  covering  are  not  reported. 

Cuts  in  diffusion  or  poly  that  do  not  have  metal  covering  are  not  reported  (dre  only). 

Diagonal  spacing  checks  do  not  consider  the  true  diagonal  distance. 

SUGGESnONS 

Do  not  have  basenames  beginning  with  a  number.  Otherwise,  this  leads  to  serious  errors  in 
that  edre  assumes  that  to  be  the  lambda  value. 

Try  to  have  as  short  a  basename  as  posnble.  This  is  because  some  flavors  of  UNIX  restrict  the 
length  of  filenames.  Some  of  the  intermediate  files  that  are  generated  have  quite  long  names. 

The  default  lambda  is  50  centimicrons  for  the  cdre  routines.  This  scaling  is  done  to  overcome 
the  inability  of  the  routines  to  check  for  non-integer  lambda  violations. 

It  is  advisable  to  run  [c)drc  in  the  background  (batch  mode),  directing  the  output  to  a  file,  so 
you  can  look  at  the  file  later  if  needed. 


UW/NW  VLSI  Release  2 


3 


6/4/84 


CIF2CA(CAD) 


UNIX  Programmer’s  Manual 


CIF2CA(CAD) 


NAMK 

cifZca  -  convert  ciF  files  to  CAESAR  files 
SYNOPSIS 

clflca  [  -1  lambda  ]  [  -t  teek  ]  [  -•  offset )  ciffile 
DESCRIPTION 

ei/2ea  accepts  as  input  a  CIF  file  and  produces  a  caesar  file  for  each  defined  symbol.  Specify* 
ing  the  -I  lambda  option  scales  the  output  to  lambda  centi-microns  per  lambda.  The  default 
scale  is  200  centi-microns  per  lambda.  The  -t  tech  option  causes  layers  from  the  qiecified 
technology  to  be  acceptable.  The  default  technology  is  nmos.  For  a  list  of  acceptable  techno¬ 
logies,  see  caesar  (1).  The  -o  offset  option  causes  all  CIF  numbers  to  be  incremented  by 
offset.  This  is  useful  when  the  Cff  numbers  are  used  for  Caesar  file  names,  and  when  sever^ 
CIF  files  with  overlqiping  numbers  are  to  be  joined  together  in  Caesar. 

Each  symbol  defined  in  the  CIF  file  creates  a  caesar  file.  By  default,  the  files  are  named 
“symbolmxa”,  where  m  is  the  CIF  symbol  number  (as  modified  by  the  -•  offset).  Symbols  can 
also  be  named  with  a  user-extension  command,  giving  a  name  to  the  symbol-  definition 
which  encloses  it.  cif  commands  which  appear  outside  of  symbol  definitions  are  gathered  into 
a  symbol  called,  by  default,  ‘project’*,  and  are  output  to  the  caesar  file  “projectxa**. 

SEE  ALSO 

caesar (1) 

IHAGNOSnCS 

Diagnostics  from  cif2ca  are  supposed  to  be  self-explanatory.  Each  diagnostic  gives  the  line 
number  from  the  input  file,  an  error  class  (informational,  warning,  fatal,  or  panic),  the  error 
message,  and  the  action  taken  by  cifTca,  usually  to  igpore  the  cif  command.  Informational 
messages  usually  refer  to  limitations  of  cifZca.  Warning  messages  usually  refer  to  inconsisten¬ 
cies  in  the  cif  file,  these  will  typically  remit  in  caesar  files  which  do  not  accurately  reflect 
the  input  CIF  file.  Fatal  messages  refer  to  fatal  inconsistencies  or  errors  in  the  CIF  file.  A  fatal 
error  terminates  ciflca  processing.  Panic  messages  refer  to  internal  problems  with  ciflca.  If 
any  diagnostics  are  produced,  a  summary  of  the  diagnostics  is  produced. 

AUTHOR 

Peter  B.  Kessler,  bug  fixes  and  new  features  by  John  Ousterhout  and  Steve  Rubin. 

BUGS 

“Delete  Definitions’*  commands  are  not  implemented.  cif2ca  also  has  certain  restrictions  due 
to  restrictions  of  caesar:  e^.  non-manhattan  objects  are  not  allowed. 

Library  cells  are  not  automagically  included. 

Some  care  should  be  taken  in  naming  symbols,  since  symbol  names  are  used  for  caesar  file 
names.  Names  which  are  not  unique  in  the  first  14  characters  will  attempt  to  create  the  same 
CAESAR  file,  and  only  the  last  one  wins.  Similarly,  one  should  avoid  trying  to  have  two 
projectxs  files  in  the  same  directory. 
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NAME 

cifploc  -  CIF  interpreter  and  plotter  for  displaying  VLSI  circuits 
SYNOPSIS 

cifpint  [ep$ioiu]fiUlxii  \fUe2x\t ...] 

DESCKIPnON 

Cifptot  takes  a  description  in  Cal*Tech  Intermediate  Form  (CIF)  and  produces  a  plot.  CIF  is 
a  low'level  graphics  language  suitable  for  describing  integrated  circuit  layouts.  Although  CIF 
can  be  used  for  other  graphics  applications,  for  ease  of  discussion  it  will  be  assumed  that  CIF 
is  used  to  describe  integrated  circuit  designs.  Cifplot  interprets  any  legal  CIF  2.0  description 
including  symbol  renaming  and  Delete  Definition  commands.  In  addition,  a  number  of  local 
extensions  have  been  added  to  CIF,  induding  text  on  plots  and  include  files.  These  ate  dis¬ 
cussed  later.  Care  has  been  taken  to  avoid  any  arbitrary  restrictions  on  the  CIF  programs  that 
can  be  plotted. 

To  get  a  plot  call  cifplot  with  the  name  of  the  CIF  file  to  be  plotted.  If  the  CIF  description  is 
divided  among  several  files  eaU  ei/p/er  with  the  names  of  all  files  to  be  used.  Caplet  reads  the 
CIF  description  from  the  files  in  the  order  that  they  appear  on  the  command  Itoe.  Therefore 
the  CIF  Eod  command  should  be  only  in  the  last  file  since  cifplot  ignores  everything  after  the 
End  command.  After  reading  the  CIF  description  but  before  plotting,  cif^ot  will  print  a  esti¬ 
mate  of  the  sixe  of  the  plot  and  then  ask  if  it  should  continue  to  produce  a  plot.  Type  y  to 
proceed  and  n  to  abort.  A  typical  run  might  look  as  follows: 

%  dfplet  Ubxif  sorter  xlf 
Window  -3700  174000  -76500  168900 
Scale:  1  micron  is  OJ0O4O7S  inches 
The  plot  will  be  0.610833  feet 
Do  yon  want  a  plot?  y 

After  typing  y  cifplot  will  produce  a  plot  on  the  Benson-Varian  plotter. 

Cifplot  recognizes  several  command  line  options.  These  can  be  used  to  change  the  size  and 
scale  of  the  plot,  change  default  plot  options,  and  to  select  the  output  device.  Several  options 
may  be  selected.  A  dash(-)  must  precede  each  option  specifier.  The  following  is  a  list  of 
options  that  may  be  included  on  the  command  line: 

-w  xmin  xmax  ymin  ymax 

(window)  This  option  specifies  the  window;  by  default  the  window  is  set  to  be  large 
enough  to  contain  the  entire  plot.  The  windowing  commands  lets  you  plot  just  a  small 
section  of  your  chip,  enabling  you  to  see  it  in  better  detail.  Xmin.  xmax.  ymin.  and 
ymax  should  be  specified  in  CIF  coordinates. 

-s  flottt 

(scale)  This  option  sets  the  scale  of  the  plot.  By  default  the  scale  is  set  so  that  the 
window  will  fill  the  whole  page.  Float  is  a  fioating  point  number  specifying  the 
nnmber  of  inches  which  represents  1  micron.  A  recommended  size  is  0112. 

-1  l^erlltt 

(layer)  Normally  all  layers  are  plotted.  This  option  specifies  which  layers  NOT  to  plot. 
The  laytrlist  consists  of  the  layer  names  separated  ^  eommas,  no  spaces.  There  ate 
some  reserved  names:  allTcxt,  bbox,  ooUlnc,  test,  potatName,  and  symbelNams. 
Including  the  layer  name  allTczt  in  the  list  suppresses  the  plotting  of  text;  bbox 
suppresses  the  btwnding  box  around  symbols.  entUne  suppresses  the  thin  outline  that 
borders  each  layer.  The  keywords  test,  poIntNams,  and  symbolName  suppress  the 
plotting  of  certain  text  created  by  local  extension  commands,  text  eliminates  text 
created  by  user  extension  2.  pelntNama  eliminates  text  created  by  user  extension  94. 
symbolName  eliminates  text  created  by  user  extension  9.  allTcit,  poIntName.  and 
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sjrabelNaow  may  be  abbreviated  by  at,  pn,  and  sa  repectively. 

-e  A  (copIca)  Makes  a  copies  of  the  plot.  Works  only  for  the  Varian  and  Versatec.  Default 
is  1  copy. 

-d  A  (depth)  This  option  lets  you  limit  the  amount  of  detail  plotted  in  a  hierarchically 
designed  chip.  It  will  only  instanciate  the  plot  down  a  levels  of  calls.  Sometimes  too 
much  detail  can  hide  important  features  in  a  circuit. 

-g  A  (grid)  Draw  a  grid  over  the  plot  with  spacing  every  a  CIF  units. 

-h  (balf)  Plot  at  half  normal  resolution.  (Not  yet  implemented.) 

-e  (catcnslens)  Accept  only  standard  CIF.  User  extensions  produce  warnings. 

-I  (neB'lnternctlve)  Do  not  ask  for  confirmation.  Always  plot. 

-L  (Ust)  Produce  a  listing  of  the  CIF  file  on  standard  output  as  it  is  parsed.  Not  recom* 
mended  unless  debugging  hand-coded  CIF  since  CIF  code  can  be  rather  long. 

-a  A  (apprextmate)  Approximate  a  roundflash  with  an  A-sided  polygon.  By  default  a  equals 
8.  (Ix.  roundfla^es  are  approximated  by  octagons.)  If  a  equals  0  then  output  circles 
for  roundfiashes.  (It  is  best  not  to  use  foil  circles  since  they  significantly  slow  down 
plotting.)  (Full  eiretes  not  yet  implemented.) 

-b  “texF 

(banner)  Print  the  text  at  the  top  of  the  plot. 

-C  (Conunents)  Treat  comments  as  though  they  were  spaces.  Sometimes  CIF  files  created 
at  other  universities  will  have  several  errors  due  to  syntactically  incorrect  comments. 
(I.e.  the  comments  may  appear  in  the  middle  of  a  CIF  command  or  the  comment  does 
not  end  with  a  semi-colon.)  Of  course,  CIF  files  should  not  have  any  errors  and  these 
comment  related  errors  must  be  fixed  before  transmitting  the  file  for  fabrication.  But 
many  times  fixing  these  errors  seems  to  be  more  trouble  than  it  is  worth,  especially  if 
you  just  want  to  get  a  plot.  Hiis  option  is  useful  in  getting  rid  of  many  of  these  com¬ 
ment  related  syntax  errors. 

-r  (rotate)  Rotate  the  plot  90  degrees. 

-N  (Prlntronlx)  Send  output  to  the  Printronix. 

-V  (Varian)  Send  output  to  the  Varian.  (This  is  the  default  option.) 

-W  (Wide)  Send  output  directly  to  the  Versatec. 

-S  (Spool)  Store  the  output  in  a  temporary  file  then  dump  the  output  quickly  onto  the 

Versatec.  Makes  nice  criqi  plots;  also  takes  up  a  lot  of  disk  space. 

-T  (Tomlnal)  Send  output  to  the  terminal.  (Not  yet  fully  implemented.) 

-Gh 

-Ga  (Graphics  tarmlaal)  Send  output  to  terminal  using  it’s  graphics  capablities.  -Gh  indi¬ 
cates  that  the  terminal  is  an  HP2648.  -Ga  indicates  that  the  terminal  is  an  AED  512. 

-X  basename 

(extractor)  From  the  CIF  file  create  a  circuit  description  suitable  for  switch  level 
simulation.  It  creates  two  files:  basename  Jim  which  contains  the  circuit  description, 
and  bcuenasneMdn  which  contains  the  node  numben  and  their  location  used  in  the 
circuit  description. 

When  this  option  is  invoked  no  plot  is  made.  Therefore  it  is  advisable  not  to  use  any 
of  the  other  options  that  deal  only  with  plotting.  However,  the  -w,  -I,  and  -a  options 
are  still  appropriate.  To  get  a  plot  of  the  circuit  with  the  node  numbers  call  eifplot 
again,  without  the  -X  option,  and  include  basename jaeAta  in  the  list  of  CIF  files  to  be 
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plotted.  (This  file  must  appear  ia  the  list  of  files  before  the  file  with  the  GIF  End 
command.) 

-c  H  (copIca)  This  option  specifies  the  number  of  copies  of  the  plot  you  would  like.  This 
allows  yon  to  get  many  copies  of  a  plot  with  no  extra  computation. 

-P  patteritfile 

(Pattern)  This  option  lets  you  specify  your  own  layers  and  stipple  patterns.  Patternfile 
may  contain  an  arbitrary  numb^  of  layer  descriptors.  A  layer  descriptor  is  the  layer 
name  in  double  quotes,  followed  by  8  integers.  Each  integer  specifies  32  bits  where 
ones  are  black  and  zeroes  are  white.  Thus  the  8  integers  specify  a  32  by  8  bit  stipple 
pattern.  The  integers  may  be  in  dedmal,  octal,  or  hex.  Hex  numbers  start  with  ’Ox’; 
octal  numbers  start  with  'O’.  The  GIF  qmtax  requires  that  layer  names  be  made  up  of 
only  uppercase  letteis  and  digits,  and  not  longer  than  four  characters.  The  following 
ia  example  of  a  layer  description  for  poly>ailicon: 

0x06080806  0x04040404  0x02020202  OiOlOlOlOl 
0x80808060  0x40404040  0x20202020  0x10101010 

-P  fomtfiUnamt 

(Font)  This  option  indicates  which  font  you  want  for  your  text.  The 
fonrfittH  amt  must  be  in  the  directory  liurHtblvfoni.  The  default  font  is  Roman 
6  point.  Obviously,  this  option  is  only  useful  if  you  have  text  on  your  plot. 

-O  filename 

(OntpnC)  After  parsing  the  GIF  files,  store  an  equivalent  but  easy  to  parse  GIF 
description  in  the  specified  file.  This  option  removes  the  include  and  array  commands 
(see  next  section)  and  replaces  them  with  equivalent  standard  GIF  statements.  The 
resulting  file  is  suitable  for  transmission  to  other  facilities  for  fabrication. 

In  the  definition  of  GIF  provisions  were  made  for  local  extensions.  All  extension  commands 
begin  with  a  number.  Part  of  the  purpose  of  these  extensions  is  to  test  what  features  would 
be  suitable  to  include  as  part  of  the  standard  language.  But  it  is  important  to  realize  that 
these  extensions  are  not  standard  GIF  and  that  many  programs  interpreting  GIF  do  not  recog* 
nize  them.  If  you  use  these  extensions  it  is  advisable  to  create  another  GIF  file  using  the  -O 
options  described  above  before  submitting  your  circuit  for  fabrication.  The  following  is  a  list 
of  extensions  recognized  by  cifplot. 

01  fUename\ 

(Inclndc)  Read  from  the  specified  file  as  though  it  appeared  in  place  of  this  command. 
Include  files  can  be  nested  op  to  6  deep. 

OA  s  mndxdy  i 

(Amy)  Repeat  symbol  s  m  tinms  with  dx  spacing  in  the  x-direction  and  n  times  with 
dy  spacing  in  the  y*direction.  t.  m,  and  n  are  unsigned  integers,  dx  and  dy  are  signed 
integers  in  GIF  units. 

1  mestaget 

(Print)  Print  out  the  message  on  standard  output  when  it  is  read. 

1  *texf  traatfarm  | 

2C  *re»*  tran^orm ; 

(Text  on  Plot)  Text  is  placed  on  the  plot  at  the  position  specified  by  the  transforma¬ 
tion.  The  allowed  transformations  are  the  same  as  the  those  allowed  for  the  Gall  com¬ 
mand.  The  transformation  affects  only  the  point  at  which  the  beginning  of  the  text  is 
to  appear.  The  text  is  always  plotted  horizontally,  thus  the  mirror  and  rotate  transfor¬ 
mations  are  not  really  of  much  use.  Normally  text  is  placed  above  and  to  the  right  of 
the  reference  point.  The  2C  command  centers  the  text  about  the  reference  point. 
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9  tuatu; 

(Nmm  sfmbol)  lUKu  11  associated  with  the  current  symbol. 

94  tiaiMxy; 

94  luuiu  xy  layer; 

(Name  point)  name  is  associated  with  the  point  (z.  y).  Any  mask  geometry  crossing 
this  point  is  also  associated  with  name.  If  layer  is  present  then  just  geometry  crossing 
the  point  on  that  layer  is  associated  with  name.  For  plotting  this  command  is  similar 
to  text  on  plot.  When  doing  circuit  extraction  this  command  is  used  to  give  an  explicit 
name  to  a  node.  Name  must  not  have  any  ^acea  in  it,  and  it  should  not  be  a  number. 

FILES 

*cad/xadrc 

'/xadrc 

~cad/bin/vdump 

/usr/lib/vfont/Rj6 

/ttsr/tmp/#cif« 

SEE  ALSO 

cadrc(cadS) 

A  Golde  to  LSI  Implementation,  Hon  and  Sequin,  Second  Edition  (Xerox  PARC,  1980)  for  a 
description  of  GIF. 

AUTHOR 

Dan  Fitzpatrick  (UCB) 

MODIFICATIONS 

(UW/NW  VLSI  Consortium,  University  of  Washington) 

BUGS 

The  ~r  is  somewhat  kludgy  and  does  not  work  well  with  the  other  options.  Space  before 
semi-colons  in  local  extensions  can  cause  syntax  errors. 

The  -O  option  produces  simple  cif  with  no  scale  factors  in  the  DS  commands.  Because  of  this 
you  must  supply  a  scale  factor  to  some  programs,  such  as  the  -I  option  to  eifZca. 

The  -X  option  does  not  work  for  non-manhattan  circuits. 
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NAME 

decNor  ->  Generates  CMOS  dynamic  NOR  form  decoder  layouts. 

SYNOFSIS 

dccNar  Inpata  [Ourfi/e] 

DESCRIPTION 

DccNor  is  a  program  for  generating  CMOS  dynamic  NOR  form  decoder  layouts  in  the  'caesar* 
format.  DecNor  constructs  caesar  composition  cells  from  caesar  leaf  cells  and/or  other  compo* 
sition  cells.  All  caesar  cells  reside  in  the  7ca  directory.  Leaf  cells  have  names  of  the  form 
decNor_*jCa  while  composition  ceils  have  names  of  the  form  *OutFile**xa.  Leaf  cells  must  be 
copied  from  $UW_VLSI_TOOLS/iib/generatots/decNor  into  7ca  before  running  decNor.  The 
completed  layout  resides  in  *OutFiie*xa.  Inputs  are  the  number  of  inputs  to  the  decoder. 
'OutFile*  can  not  begin  with  the  string  'decNot*.  The  default  for  'OutFile*  is  the  string 
'decGen'. 

As  decNor  is  a  cfl-based  program  it  creates  files  of  the  form  v.bd  in  7ca. 

The  following  table  describes  decNor’s  optiota  although  an  abreviated  listing  can  be  obtained 
by  invoking  decNor  with  no  arguments.  Options  prepended  by  *•*  are  active  while  those  with 
•if  have  not  been  implemented. 

-f  Stripped  down  layout  for  floor  planning.  Ceils  which  occupy  a  large  part  of  the 
decker  are  represented  in  dummy  layers  allowing  faster  layout  generation. 

-t  Layout  of  worst  case  path  for  timing  estimates.  Cells  which  are  not  part  of  the 
slowest  electrical  path  are  represented  in  dummy  layers  allowing  faster  generation, 
extraction  and  simulation. 

-s  A  schematic  of  the  decoder.  Cells  are  represented  as  symbols  (wires  and  transistor?) 
drawn  in  black  ink  (labels)  on  a  yellow  background  (P-f  nuuk). 

*p  P'type  decode  transistors.  Since  N>type  transistors  have  a  lower  on  resistance  they  are 
the  default  decode  transistor  type. 

-I  Labels  are  added  to  inputs  and  outputs.  Since  labels  increase  the  generation  time  they 
are  not  added  as  the  default.  When  included  they  are  prepended  with  'OutFile'. 

-b  banka 

The  array  of  decode  transistors  will  be  repeated  *  banks  *  times.  This  feature  can  be 
used  to  distribute  decoder  outputs  to  a  number  of  places  with  minimal  additional  area. 
Default  is  one. 

•o  outs 

Stretch  decoder  to  give  *  outs  ’  lambda  output  spacing.  This  option  simplifies  connec¬ 
tion  by  abutment. 

«l  ins 

Grow  decode  xsistors  to  give  *  ins  *  lambda  input  spacing.  This  option  allows  the 
decoder  to  operate  faster. 

•V  vtr 

Grow  input  inverten  to  fill  vertical  size  of  *  ver  *  lambda.  This  option  allows  the 
decoder  to  operate  faster. 

•b  hor 

Grow  evaluate/charge  xsistors  to  fill  horizontal  size  ot  "  bar  *  lambda.  This  option 
allows  the  decoder  to  operate  faster. 
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FILES 

yca/OutFile*jca 

yca/OutFiIe*.bd 

yca/decNor_«.ca 

SEE  ALSO 

caesar(CADl),  cfl(5.vlsi) 

AUTHORS 

David  J.  Morgan 
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NAME 

eqntott  -  generate  truth  table  from  Boolean  equations 
SYNOPSIS 

eqntott  [  -I  J  [  -f  I  [  1  [  -r  ]  [  -R  1 1  ( -Jtey  ]  (  cc  options  I  [  files  ] 

DESCRIPTION 

Etpao$t  generates  a  truth  table  suitable  for  PLA  programming  from  a  set  of  Boolean  equations 
whieh  define  the  PLA  outputs  in  terms  of  its  inputs.  When  neither  -f  nor  -s  is  specified,  input 
and  output  variables  must  be  mutually  exclusive.  If  the  -s  option  is  given,  an  output  variable 
may  be  used  in  an  expression  defining  another  output  variable:  the  expression  for  the  first  out¬ 
put  is  substituted  for  the  the  name  of  that  output  when  it  is  encountered.  The  -f  option 
allows  outputs  to  be  defined  in  terms  of  their  previous  values  in  a  s3mcbronous  system  (e.g.  an 
FSM):  the  same  name  appearing  as  both  an  input  and  an  output  may  be  thought  of  as  refer¬ 
ring  to  two  distinct  variables,  or  the  same  variable  at  two  distinct  times.  (The  -f  and  -s 
options  are  mutually  exclusive.) 

If  the  -r  option  is  qyecified,  eqntott  will  attempt  to  reduce  the  size  of  the  truth  table  by  merg¬ 
ing  minterms.  The  -R  option  (implies  -r)  forces  eqntott  to  produce  a  truth  table  with  no 
redundant  minterms.  The  truth  table  generated  does  not  represent  a  minimal  covering  of  the 
truth  functions,  but  does  preserve  some  'don’t  care'  information  for  some  other  program  to 
use. 

If  the  -1  option  is  specified,  eqntott  will  output  a  truth  table  which  includes  the  name  of  the 
pla  and  its  inputs  and  outputs  as  specified  in  PLA(S). 

The  form  that  the  output  takes  is  controlled  by  the  string  key,  described  below.  Input  is  taken 
from  files  (standard  input  default)  and  run  through  the  C  macro  preprocessor  of  ce(l),  to  per¬ 
mit  comments,  file  inclusion,  macros,  and  conditional  processing.  The  ce  options  -D,  -I,  and  -U 
are  recognized  and  passed  on  to  the  preprocessor. 

Equatto*  Syatai: 

name  =  expression; 

Associates  a  truth  function  defined  by  expression  with  the  output  name,  both  of  which 
are  defined  below.  If  an  output  name  is  assigned  more  than  one  expression,  the  effect 
is  identical  to  a  single  assignment  to  the  output  of  the  logical  disjunction  of  all  the  ori¬ 
ginal  expressions. 

NAME  =  name  ; 

Defines  the  name  of  the  pla  to  be  'name'.  If  not  specified,  the  name  of  the  pla  is  the 
name  of  the  input  file  with  any  postfixes  removed. 

INORDER  =  name  [name]... ; 

Defines  the  order  in  which  inputs  appear  in  the  truth  table.  If  not  specified,  the  order 
is  that  in  which  the  inputs  appear  in  the  source. 

OUTORDER  =  name  [name]... ; 

Defines  the  order  in  which  outputs  appear  in  the  truth  table.  If  not  specified,  the 
order  is  that  in  which  the  outputs  appear  in  the  source. 

EspmsiM  Sjataz: 
name 

A  name  is  used  to  specify  an  input  or  output.  The  name  must  begin  with  a  letter  or 
underscore;  subsequent  characters  may  be  letters,  digits,  underscores,  asterisks, 
periods,  square  brackets,  or  angle  brackets. 
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ZERO  (or  0) 

Bttiltin  input  that  always  has  the  value  zero  (false). 
ONE  (or  1) 

Builttn  input  that  always  has  the  value  one  (true). 


? 

Builtin  input  that  always  has  the  value  'don’t  care'. 

(  e]q)ression  ) 

Parenthesis  may  be  used  to  change  the  order  of  evaluation. 

!  expression 

Gives  the  complement  of  expreuton. 
expression  &  expression 

Gives  the  logical  conjunction  of  the  two  expressions.  The  A  operator  associates  left  to 
right,  and  has  the  same  precedence  as  L 

expression  I  expression 

Gives  the  logical  disjunction  of  the  two  expressions.  The  I  operator  also  associates  left 
to  right,  and  has  a  lower  precedence  than  A. 

Oatpat  Faraat 

The  output  format  may  be  controlled  to  a  small  extent  using  the  character  string  key.  The 
string  is  scanned  left  to  right,  and  at  each  character  code,  a  piece  of  output  is  generated 
corresponding  to  the  character  encountered.  If  ‘Jtey  is  not  specified,  the  string  'iopte*  is  used, 
or  'iopfte*  with  the  'f  option. 

code  output  generated 
c  .c 

f  .f  output-number  input-number 

(one  line  for  each  feedback  path,  numbers  refer  to  Or-  and  And-plane  truth  table 
column  numbers) 

h  a  human  readable  version  of  the  truth  table  (q.v.) 

I  .1  number-cf -inputs 

I  .1  input-name 

(one  line  for  each  input,  in  order) 

I  a  truth  table  with  the  name  of  the  pla,  its  inputs  and  its  outputs 
p  .p  number-of -product-terms 

B  M  number-of -product-terms 

a  M  number-of -outputs 

O  .O  output-name 

(one  line  for  each  output,  in  order) 

S  PLA  connectivity  summary 

t  PLA  personality  matrix  (q.v.) 

V  eqntott  version  information 

The  truth  table  (personality  matrix)  consists  of  a  line  for  each  minterm,  beginning  with  that 
minterm  and  followed  by  the  values  of  the  various  outputs.  The  minterm  is  composed  of  a 
single  character  (0, 1,  or  -)  for  each  input  in  the  conventional  fashion.  The  output  values  are 
represented  by  one  of  the  three  characters  (0,  1,  or  x).  Some  white  space  is  added  for 
readability’s  sake. 
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In  the  human  readable  format,  each  line  of  output  represents  one  term  in  the  sum-of-products 
expression  for  an  output.  The  line  begins  with  the  name  of  the  output,  which  is  enclosed  in 
parentheses  for  the  value  “don’t  care*.  Then  follow  the  names  of  the  inputs  in  the  product; 
complemented  inputs  are  preceded  by  a  f. 

SEE  ALSO 

cc(l). 

OIAGNOCTICS 

Syntax  errors  are  written  to  the  standard  error  output  and  should  be  self-explanatory. 

BUGS 

•I  should  be  the  default,  but  some  pla  tools  can’t  handle  the  full  format.  Eqntott  likes  its 
option  seperately;  ije.  -f  -I  works  but  -11  doesn’t. 

AUTHOR 

Bob  Cmelik. 

-1  option  added  by  Jeff  Deutsch. 
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NAMK 

geii_control  -  generate  a  control  file  for  RNL 

SYNOPSIS: 

gcB.coBtrel 
(no  arguments) 

DESCBlPnON 

gtHj:ontrol  is  a  program  designed  to  quickly  specify  a  control  file  for  RNL  simulation. 
gen^eontrol  provides  for  the  proper  insertion  of  quotes  and  use  of  parenthesis. 

Typical  file  extensions  to  the  baaenamcs  are  assumed. 

When  starting  up  the  geH_coiaroi  program,  the  user  will  be  prompted  for  the  necessary 
information  to  be  provided. 

Assumed  standard  libnmes  are: 

uwatdJ  A  awstmJ 


Prompts: 

1.  Basename: 

The  control  file  will  be  written  in:  basenamai 
In  the  1  or  control  file  assumed  extensions  are: 
toe  the  log  file:  basename xtog 
for  the  network:  basename 
toe  the  plotfile:  basenamebeh 

2.  Comment: 

A  one  line  comment,  which  could  be  a  short  comment  about  the  simulated  circuit  can  be 
entered. 

3.  Simulation  step  increment  value: 

Enter  the  value  of  the  simulation  step  in  0.1  ns  units.  The  appropriate  lisp  command  is 
automatically  generated. 

4.  Definition  of  normal  vectors: 

To  define  a  vector  enter  its  name. 

Then  there  will  be  a  prompt  for  its  type  (bit,  bin,  oct,  hex,dec) 

Followed  by  a  prompt  for  its  elements. 

A  <  CR>  means  skip  this  entry. 

5.  Definition  of  single  indexed  vectors: 

Enter  basename  and  after  prompts:  type,  start  index  and  number  of  elements. 

6.  Definition  of  a  set  of  double  indexed  vectors: 

Enter  basename  and  after  prompts:  type,  indexsizel  and  indexsize2. 

7.  Definition  of  report  toe  end  of  simulation  step: 

One  of  two  types  can  be  specified: 

Just  a  <  CR>  specifies  the  normal  def-report  contents; 

<any  character><CR>  specifies  an  optional  type  in  which  multiple  vectors  with  double 
indexed  nodes  can  be  specified. 

Next  there  will  be  a  prompt  for  a  comment  to  be  included  in  every  report  (this  portion  only  is 
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optional). 

Then  there  will  be  prompting  until  a  <  CR>  is  entered  for 

nodenames  (just  enter  the  names)  or 
a  vector  name  (first  enter  *vee'  and  then  the  name). 

In  case  of  the  optional  report  format,  the  multiple  vector  specification  format  is  obtained  by 
reponding  with  \teV.  Additional  prompts  will  follow  for  basename  and  size. 

8.  Selection  of  output  mode:  logic  analyzer  style  output: 

Enter  any  character  for  selecting  logic  analyzer  style  output  and  a  <  CR>  for  standard  out¬ 
put. 

A  report  stating  the  order  of  columns  in  the  output  of  RNL  will  be  automatically  generated. 

9.  Selection  of  output  mode:  glitch  detection  reporting: 

Enter  any  character  for  selecting  glitch  detection  and  a  <CR>  for  standard  reporting  of 
transients. 

10.  Definition  of  nodes  with  transient  or  glitch  reporting: 

Individual  node  names,  vectors  with  single  indexed  node  names  and  vectors  with  double 
indexed  node  names  can  be  specified.  Respond  appropriately  for  names  vectorsizes. 

11.  Definition  of  logic  trigger  conditions: 

There  are  prompts  for  defining  trigger  conditions  on  individual  node  names,  single  vectors  in 
invec  type  format,  and  single  vectors  in  bitinvec  type  format. 

12.  Definition  of  additional  RNL  simulation  set-up  commands: 

Enter  the  desired  RNL  commands.  Terminate  with  an  additional  <  CR> . 

13.  Definition  of  a  timing  pattern  file: 

Respond  with  <  CR>  if  there  is  no  such  file  (unlikely)  or  any  other  character  if  such  is  the 
case. 

The  filename  assumed  is:  baacaamc.Uaa 

14.  Definition  of  wrap-up  RNL  commands: 

Enter  the  desired  simulation  wrap-up  commands  (often  Just  ’exit’). 

There  is  no  s)mtax  checking  in  gem_eoiarol.  gen_coiurol  will  put  the  quotes  and  parentheses  at 
the  right  places.  Any  errors  can  be  easily  corrected  using  a  standard  text  editor  on  the  output 
file:  bastnamai. 

This  file  can  be  inspected  for  correctness.  Errors  may  be  reported  by  RNL  when  running  the 
simulation. 

HLES 

The  output  file  is  an  ascii  file  and  can  be  inspected.  The  files  containing  the  library  functions, 
network  etc.  must  be  at  the  correct  place. 

HwttdJ,  uwtiml,  batemunaJ,  basenama,  basanamarlog,  basanamaJbah,  basename  Sima 
SEE  ALSO 

genjima  manual  instructions 
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AUTHOR 

Henriecus  Koeman,  John  Fluke  Mfg.  Co..  Inc. 

OUGNOSICS 

none 

BUGS 

Please  let  the  author  know. 
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NAME 

gen.time  -  generate  a  stimulus  pattern  for  ml. 

SYNOPSIS 

gmjbnt  input  JU*  output  Jilt 
DESCEIPTION 

genjime  is  a  program  designed  to  quickly  specify  input  signal  patterns  which  can  be  read  by 
the  lisp  command  interpreter  of  RNL.  gen_time  accepts  a  simple  syntax  without  quotes  and 
parentheses  and  accepts  a  simple  means  for  defining  states  or  commands  for  specific  moments 
in  time.  The  output  of  gen_time  is  typically  read  by  the  main  control  file,  which  contains  the 
set-up  information  for  the  simulation.  This  control  file  can  easily  be  obtained  using  the 
gen_control  program.  One  of  the  cmnmands  should  *Ioad*  the  outputfile  of  gen_time. 


Syntax  summary: 

titne_range  <  start_time>  <  stop_time> 

(must  be  the  first  command) 

nodejtame  <pttmA>  <statei>  <timel>  <state2>  <time2> 
invec  <vector_name>  <period>  <valuel>  <timel>  ~.. 
bitinvte  <  vector_name>  <  period>  <  bitvaluesl>  <  timel>  ... 
(note  no  spaces  between  individual  bitvalues  as  in  the 
equivalent  ml  command!) 

command  <period>  <  rol_commandl>  <timel>  ..... 

(no  alternate  syntax  allowed  in  raljcommands  here) 
report  <  period>  <  timel>  <  time2> 

(report  1 0  generates  a  report  after  every  time 
step) 

(must  be  the  last  command  in  the  input_file) 
mask  <  period>  <  enable jtiine>  <  disable_time> 

(applies  only  to  command  line  immediately  following) 
mosk/nv  <  period >  <  disable_time>  <  eeable_time> 

(applies  only  to  command  line  immediately  following) 


FILES 

The  output  file  is  an  ascii  file  and  can  be  inspected  for  programmed  activity  as  a  function  of 
the  time  increments. 

FURTBEK  EXPLANATIONS 

The  rules  for  the  input  file  are  discussed  in  more  detail  in  the  following,  in  particular  those 
for  the  mote  complex  waveforms. 

Rale  #1:  Comments. 

All  lines  starting  with  a  semicolon  are  considered  comments  and  are  ignored. 

Rale  #2:  Simulation  interval  definition  must  come  first. 

The  first  command  in  the  atim  file  must  be  the  specification  of  the  simulation  interval;  syntax 
and  example: 

time_range  <  start Jime>  <stop_time> 
time.range  0  SO 

Note:  Every  value  of  time  is  in  number  of  simulation  step  increments  ’incr’.  The  global 
variable  *incr’  is  assigned  a  value  with  (setq  incr  <  number> )  where  the  number  is 
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the  size  of  the  simulation  step  in  0.1  ns;  this  is  done  in  the  ('J'^  RNL  control  file. 

Rale  #3:  The  report  definition  must  come  last. 

The  last  command  in  the  atim  file  must  be  the  specification  of  how  often  RNL  should  print  a 
report  (using  the  def-report  specification):  syntax  and  examples: 

report  <period>  <timel>  <time2>  — 

report  2  1  (report  every  2  simulation  steps  at  the  end  of  interval  1;  which 

occur  at  t=2, 4. 6,  etc.) 

report  10  3  6  9  (report  every  10  simulation  steps  at  the  end  of  intervals  3,6  and  9: 
t=4,  t=7,  t»10,  t=14,  t»17,  t=20  etc) 

report  1  0  (report  at  the  end  of  every  simulation  step) 

Rale  #4:  How  input  signals  are  specified. 

Signals  are  defin^  in  one  of  the  following  ways: 

nodename  (states  must  be  I,  h,  u  or  x) 

invee  vectomame  (states  must  be  a  numerical  type: 

decimal,  octal  (leading  '0*), 
hexadecimal  (0x_.)  or  binary  (Ob...)) 

bitinvec  vectomame  (states  can  be  any  combination  of  l,0,u  and  x;  no  spaces  between  the 
elements) 

followed  by: 

the  period,  and  a  number  of  combinations: 

<state>  <time> 

If  the  period  is  *0*  the  ^ecification  relates  to  a  one  time  event  (the  period  is  really  infinity!). 

Syntax  and  example  for  a  simple  waveform  definition  for  simple  node: 

node.name  <  period >  <statel>  <timel>  <state2>  <time2>  . 

node-namel  10h012uSx8 

period  is  10  simulation  steps,  signal  h  at  t-0, 1  at  t=2,  u  at  t=S  and  x  at  t=8; 
signalchanges  repeat  themselves  at  t^lO,  12, 15, 18, 20,  22,  etc.. 

Syntax  and  examples  for  a  numerical  vector  definition  (no  undefined  states  can  be  specified  in 
this  case!): 

invee  vectomame  <  period>  <statel>  <timel>  _ 

invee  name  10  Oxa  0  Obllll  2  07  5  3  8 

period  is  10  simulation  steps,  vector  is  the  hexadecimal  *a*  at  t==0,  binary  1111  at  t»2, 
octal  *7*  at  t=5  and  a  decimal  ’7  at  t^O.  Again,  the  pattern  is  repeated  10  simulation 
steps  later. 

invee  name  0  Oxa  0  13  S  017  9 

The  pattern  is  a  single  event:  name  is  hexadecimal  *a*  at  t=0,  a  decimal  *IS*  at  t«S;  an 
octal  *17*  at  t*9.  This  pattern  does  not  repeat  itself! 

Syntax  and  examples  for  a  bitvector  definition: 

bitinvec  <vector_name>  <period>  <statel>  _ 

bitinvec  vectomame  20  0000  0  1111 5  uuuu  10  xxxx  IS 
bitinvec  vectomame  10  Oxlx  0  uOOx  5 
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Rate  #5:  Use  of  regular  RNL  commands  allowed  only  with  standard  lisp  syntax. 

RNL  commands  can  also  be  inserted  in  the  same  manner  as  node  and  vector  stimulus;  only 
the  standard  ml  syntax  (with  parentheses  is  allowed): 
syntax: 

command  <  period>  <  (raI_commandl)>  <  timel>  _ 

Rate  #<:  Masking  of  input  signals  and  commands. 

Except  for  the  time.range  command  ALL  gen.time  commands  are  subject  to  mask  commands, 
with  will  blank  out  the  impact  of  the  next  command  line  immediately  following  the  mask  com¬ 
mand  line.  After  processing  this  next  command  line  the  mask  is  reset  to  a  default  which  is  a 
full  enable.  There  are  two  mask  commands: 

’mask’  and  ’maskinv* 

’mask’  and  ’maskinv’  themselves  are  defined  as  having  a  period  (a  one  time  mask  has  a  period 
of  V)  and  only  1  enable  and  only  1  disable  time. 

syntax: 

mask  <period>  <  enable_time>  <  disable_time> 
maskinv  <  period>  <  disable_time>  <  enable_tinie> 

Example: 
mask  0  10  20 
node2  5h0I5al0xl5 

will  blank  out  any  activity  from  node2  before 
time  increment  10  and  after  time  increment  20. 
maskinv  0  10  20 
nodes  5  h  0 1  5  u  10  X  IS 

will  allow  only  nodeS  statements  to  be 
effective  before  time  increment  10  and 
after  time  increment  20. 

The  commands  scheduled  for  the  time  coinciding  with  the  enable  time  of  the  mask  will  be 
effective,  while  the  commands  schedule  for  the  time  coinciding  with  the  disable  time  will  be 
disregarded. 

Example  of  a  typical  stimulus  file: 

;  Timing  file  for  basic  CRC  Counter 

;  Simulation  time: 

time.range  0  36 

;  Run  the  clock  at  all  times: 

cl  2  1 0  h  1 

;  Reset: 

rOhOl  1 

;  The  following  sequence  is  designed  to  exercise  all  nodes! 
in0I0h2I12h20l26h2S132h34 
;  We  will  start  reporting  the  unchanged  nodes  just  before 
;  the  last  ff  changes  state,  which  is  at  time  increment  32: 
mask  0  32  36 

command  1  (printf  'nodes  uach:%^n'  (unchanged-since  100))  0 
;  We  report  the  state  after  every  simulation  step: 
report  1  0 
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USING  PATTESNS  DEFINED  USING  GEN_TIME. 

The  output  file  from  genjime  with  the  shell  command: 
gen.time  basenamentim  basename.time 

Within  the  regular  RNL  control  file  (basename  J)  one  should  include: 

(load  'basenameiime*) 

AUTHOR 

Henriecus  Koeman,  John  Fluke  Mfg.  Co.,  Inc. 

DIAGNOSICS 

In  case  of  an  error  in  the  inputfile  geo.time  will  most  likely  print  the  first  line  number  and 
the  line  itself  where  the  error  was  detected  and  then  terminate  prematurely. 


BUGS 


Please  let  the  author  know. 
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lyra  -  Performs  hierarchies!  layout  rule  check  on  caetar  design. 

SYNOPSIS 

lyra  [-«b]  [-•  output]  (-p  path]  [-r  ruleset]  (-4  technology]  rootCaesarFile, 
or 

lym  -e  [-C  technology]  [-r  ruleset] 

DESCRIPTION 

Lyra  has  two  modes  of  operation:  it  can  be  invoked  directly  to  perform  a  batch  hierarchical 
check  of  a  caeaar  design,  or  from  the  Caesar  (or  Kie)  layout  editor  to  interactively  check  a 
portion  ot  the  design  currently  being  edited. 

In  batch  mode,  a  hierarchical  check  of  the  caetar  design  rooted  at  rootCaesarFile  is  done.  A 
log,  including  a  summary  of  errors  is  written  to  itdout,  and  a  lyra  file  'aameJjr  is  created  tor 
every  cell  'namexa*  in  which  design  rule  violations  are  detected.  The  lyra  files  fiag  each 
design  rule  violation  with  a  bright  splotch  of  paint  on  the  error  layer,  and  a  caesar  label  iden¬ 
tifying  the  type  of  violation.  The  lyra  file  for  a  cell  'narnexa*  contains  the  original  caesar  file 
as  a  subcell,  thus  the  caesar  subedit  command  can  be  used  to  conveniently  fix  design  role  vio¬ 
lations  reported  by  Lyra.  Obsolete  lyra  files  are  removed  by  Lyra  when  a  cell  checks  on  the 
current  run. 

Lyra’s  violation  messages  have  the  form: 
l<  LayersOrConstructs  >  _<  Type  > . 

Note  that  all  violation  messages  begin  with  an  exclamation  mark  (T).  LayersOrConstructs 
gives  the  single  character  abbreviations  for  the  layers  involved  in  the  t^lation.  Circuit  con¬ 
structs  such  as  transistors  and  buried  contacts  may  also  be  indicated  by  short  abbreviations 
(04.  tr  for  transistor;  Be  for  buried  contact).  Type  is  given  by  one  or  two  characters  indicating 
the  type  ot  error  as  follows: 

s  »  minimum  spacing  violation, 
w  »  minimum  width  violation, 
pe  »  parallel  edge  spacing  violation, 

X  »  insufficient  extension  or  enclosure, 
p  «  polarity,  04.  Dif.  doping  doesn’t  match  well  in  CMOS, 
f  »  malformed  circuit  construct. 

For  example,  a  spacing  violation  between  Polysilicon  and  Diffusion  would  look  like  this: 
!P/D_s. 

Note  that  Parallel  Edge  checks  are  less  restrictive  than  the  corresponding  Width  and  Spacing 
checks  would  be,  since  they  ignore  diagonal  interactions. 

The  following  rulesets  are  currently  supported  at  Berkeley: 

umMBERK 

Berkday  nMOS  mla.  Modified  Mead  A  Conway  rules.  Buried  contacts  are  supported; 
Butting  Contacts  are  disallowed.  The  Lyon  Implant  rules  are  used. 

cmos-pwJPL 

CMOS  rules  (p  well).  An  extension  of  the  Mead  and  Conway  nMOS  rules  to  CMOS, 
worked  out  by  Carlo  Sequin  in  conjunction  with  JPL. 
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nowaMC 

Maad  A  Coaway  bMOS  rnlcf  as  described  in  'Introduction  to  VLSI  Systems*  by  Mead 
and  Conway,  Butting  Contacts  are  allowed;  buried  contacts  are  not  allowed. 

emoo-pwS 

MOSIS  3  adcroB  balk  coms  preccaa,  (see  below  for  details).  This  is  the  default  ruleset 
for  technology  cmos-pw. 

cmea-Mlvl 

MOSIS  3  micrM  balk  cmoa  preecaa*  (see  below  for  details). 

Isocmos 

GTE  S  micron  Isoemoa  proceaa. 

If  the  -r  option  is  not  given,  Lyra  chooses  a  ralesei  based  on  the  technology  specified  in  the 
rootCaesarFile.  The  correspondence  between  caesar  technologies  and  default  rulesets  is 
specified  in  'cadllibIlyralDEFAVLTS.  If  Lyra  does  not  recognize  the  technology  of  the 
rootCaesarFile,  it  uses  the  default  ruleset  tar  nmoo. 

In  editor  mode  standard  input  and  standard  output  are  used  to  communicate  with  the  layout 
editor,  no  log  is  written  to  stdout!,  and  violations  are  fiagged  directly  in  the  edit  cell.  The 
caesar  technology  or  ruleset,  if  different  from  nmoa,  must  be  specified  explicitly  on  the  com¬ 
mand  line,  since  Lyra  does  not  have  direct  access  to  the  caesar  database.  Note  that  interactive 
checks  are  nonhierarchical  and  slow,  thus  it  is  a  good  idea  to  use  this  mode  only  to  check 
small  pieces  of  a  design;  complete  designs  are  best  checked  in  batch  mode. 

The  options  described  below  may  be  specified  in  a  xadre  file  or  as  command  line  options. 
Lyra  reads  options  from  'cad!  xadre,  '/xadre  and  the  command  line,  in  that  order.  If  an 
option  is  specified  in  more  than  one  place,  the  later  setting  takes  precedence.  Capitalizing  an 
option  on  the  command  line,  or  giving  the  keyword  ansct<  option  >  in  xadre  causes  the 
option  to  be  reset  to  its  default  value  (e.g.  *Iyra  -R*,  resets  any  previous  ruleset  specification, 
forcing  the  default  to  be  used). 

-e  (edit  mode)  Used  by  Caesar  and  Kle.  In  this  mode  Lyra  reads  rectangles  etc.  from  stan¬ 
dard  input  and  reports  violations  on  standard  output. 

-•  <  oatpatOlr> 

(oatpat  directory)  Gives  directory  for  I)rra  (- Jy)  files.  Defaults  to  current  directory. 

-p  <  patb> 

(search  path  for  caesar  files)  Path  gives  a  colon  ('O  separated  sequence  of  directorys 
to  be  searched  in  order  for  caesar  files.  The  default  search  path  is  just  the  current 
directory.  As  in  caesar  'cadllibicaesar  is  searched  as  a  last  resort. 

-r  <ralese(> 

(design  role  set)  Gives  ruleset  to  use.  Rulesets  are  stored  in  ' cadtlib/lyra.  A  user  can 
supply  his  own  ruleset  by  giving  the  full  pathname  on  the  -r  option  (see  mice).  If  the 
-r  option  is  not  specified,  Lyra  determines  which  ruleset  to  use  from  the  technology 
specified  in  the  rootCaesarFile  for  the  design. 

-t  <  tcelinology> 

(caesar  technology)  Used  to  specify  caesar  technology  in  editor  mode,  or  to  override  the 
technology  given  in  the  rootCaesarFile.  Lyra  uses  the  caesar  technology  to  choose  a 
default  ruleset. 

-V  (verbose  mode)  Causes  more  detailed  log  information  to  be  written  to  stdout.  This 
option  is  primarily  for  debugging. 

-a  (restart)  If  Lyra  dies  abnormally,  it  leaves  a  RESTART  file  in  the  output  directory 
which  gives  the  cells  which  were  completely  checked.  Lyra  can  then  be  restarted  with 
the  -X  option,  to  resume  checking  with  the  first  (sub)cell  not  already  checked.  Note 
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that  the  restart  option  should  only  be  used  if  the  caesar  database  for  the  project  has 
not  been  changed  since  the  time  the  original  Lyra  run  was  started. 

DIAGNOOTICS 

CMOS-FW3  MOSIS  3  MICRON  CMOS  DESIGN  RULES.  VID 

'C  sT  contact-eontact  separation:  3u 

*C  w*  contact  width:  3u 

*C2  r  inetal2  extension  around  via:  2.Su 
metal  extension  around  via:  25u 
*C2  s'  via-via  separation:  3u 

'C2  w'  via  width:  3u 

*C/C2  s*  via-cut  separation:  3u 

*D  a*  active  area-active  area  separation:  4u 

'D  nr*  active  area  width:  4u 

'Dn-t-  w*  N+  active  area  width:  4u 

'Dp+  w*  P+  active  area  width:  4u 

'Dw  w*  P-h  active  area  (not  gate)  width:  3u 
N-t-  active  area  (not  gate)  width:  3u 
*D/C2  s'  if  active  area  is  not  under  via,  via-active  area 
separation:  3u 

*D/C2  x'  if  active  area  is  under  a  via.  active  area  extension 
around  via:  3u 

'D/p+  sC  N+  active  area  to  P+  spacing:  2u 
*M  s'  metal-metal  separation:  4u 

*M  w'  metal  width:  3u 

'MP/PMM2  x'  step  missing  for  metal2  step  coverage 
”M2  f  metal2-metal2  separation:  5u 

'M2  w*  metal2  width:  5u 
*M2/P  St'  metal2/metal/poly  width:  lu 

'M/PMM2  x'  metal  step  width  for  metal2: 4u 
'M/P/M2  St'  poly-metal  separation  when  under  metal2  with  no 
overlap:  5u 

'P  s'  poly-poly  separation:  3u 

'PMC  x'  extra  .5  micron  in  direction  of  metal  in  poly-metal 
contacts 

'Pw  w*  poly  (not  gate)  width:  3u 
'P/C2  a'  if  poly  is  not  under  via,  via-poly  separation:  3u 

*P/C2  x'  if  poly  is  under  a  via,  poly  extension:  3u 

'P/D  S'  poly-active  area  separation:  2u 

'P/M/M2  St'  poly-metal  separation  when  under  metal2  with  no 
overlap:  Su 

'P/PMM2  x'  poly  step  width  for  metai2: 3u 
'T  w'  Gate  area  width:  3u 

'T/C  s'  contact  to  gate  separation:  3o 
'T/n-f  s'  P-(-  extension  around  gate  outside  p-well:  35u 
'T/p-f  s'  gate  inside  p-well  to  P-t-  (of  ohmic  contact) 
separation:  3  Ju 

'VIA  r  via  has  obtuse  comer 

'Wp  s'  (hwell  to  p-well  separation:  9u 

'Wp  w'  p-well  width:  3u 

'Wp/n-t-Wn  s'  N-t-  active  area  (ohmic  contact)  to  p-well 
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separation:  7u 

'c  r  metal  and  (poly  or  active  area)  required  under  cuts 

metal  extension  around  cut:  2u 
active  area  extension  around  cut:  2u 
poly  extension  around  cut:  2u 
"pW/n+D  X*  p-well  extension  around  active  area:  4u 
'pW/p+D  s*  separation  of  p-well  from  P-t-  active  area:  8u 
'p+  s'  p+  to  p+  separation:  3u 
'p+/D  X*  P+  extension  around  P-(-  active  area:  2u 
*sc  f*  split  ohmic  contact  must  be  4  microns  into  P-l-  active 
area  and  4  microns  into  N-t-  active  area 
*tr  f*  malformed  poly  or  active  area  abuttment:  3u  extension 
*tr  p'  polarity:  P-t-  implanted  transistor  in  p-well 

polarity:  N-i-  implanted  transistor  outside  p-well 


CMOS-PW3  MOSIS  3  MICRON  CMOS  DESIGN  RULES.  Vl.l 
Same  as  ID  with  the  following  exceptions: 
modified  rules: 

*C2  f*  metal2  extension  around  via:  2u 
metal  extension  around  via:  2u 
'M2/P  St*  metal2/metal/poly  width:  3u 
'M/PMM2  X*  metal  step  width  for  metal2: 3u 
'M/P/M2  St'  poly-metal  separation  when  under  metal2  with  no 
overlap:  3u 

'P/C2  $*  if  poly  is  not  under  via,  via-poly  separation:  4u 

*P/C2  X*  if  poly  is  under  a  via,  poly  extenaon:  4u 

'P/M/M2  St'  poly-metal  separation  when  under  metal2  with  no 
overlap:  3u 

'P/PMM2  x*  poly  step  width  for  metal2: 3u 


new  rule: 
'D  W' 


Active  Area  transistor  abuttment  width:  4u 


nLES 


'cad/bin/lyra  ~  executable  lyra. 

'cad/lib/Iyra  -•  rulesets  (in  symbolic  and  executable  form). 
'cad/lib/lyra/DEFAUL’n  -•  gives  default  rulesets  for  caesar  technologies. 


SEE  ALSO 

Rulec  (CAD) 
Caesar  (CAD) 
KIC  (CAD) 
Cif2ca  (CAD) 
Cifplot  (CAD) 

AUTHOR 

Michael  Arnold. 
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NAME 

mexnodes  -  integrate  intermediate  nodes  extracted  by  mextra  with  the  original  caesar  design. 
SYNOPSIS 

mexnedM  [options]  basename 
DESCRIPTION 

Mexnodes  is  a  shell  script  that  uses  eif2ca  and  caesar  to  generate  a  Caesar-format  file.  This  file 
allows  the  user  to  view  the  intermediate  nodes  named  by  mextra  on  the  original  design.  Mex¬ 
nodes  can  be  helpful  when  a  simulation  tool  reports  errors  at  a  node  not  named  by  the  user,  as 
such  errors  are  sometimes  hard  to  locate.  The  output  file  created  by  mexnodes  is  named 
tsabasenamexM.  This  file  can  be  then  viewed  using  caesar  in  order  to  find  a  given  node. 

The  options  are  as  follows: 

-t  technoiogy 

Technoiogy  is  one  of  nmos,  isocmos,  or  cmos-pw.  Default  is  nmos. 

-I  lambda 

Lambda  specifies  the  centimicrons  to  lambda  correspondence  of  the  design.  Default  is 
200  centimicrons  per  lambda. 

HLES 

basename  xa 
mxbasename  .CA 
basename  JXOit% 
basenamejc.it 

SEE  ALSO 

cae3ar(CADl),  cif2ca(CA01),  mextra(CADl) 

AUTHOR 

Terry  J.  Ligocki 

BUGS 
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NAME 

mextn  -  Manhattan  circuit  extractor  for  VLSI  simulation 
SYNOPSIS 

niaxtm  [-g]  [-•  scaie]  [-o]  basename 
DESCRIPTION 

Mextra  will  read  the  file  basenamejtXt  and  create  a  circuit  description.  From  this  circuit 
description  various  electrical  checks  can  be  done  on  your  circuit.  The  circuit  description  is 
directly  compatible  with  esim,  powest,  and  ere.  There  are  translation  programs  to  convert  mex¬ 
tra  output  to  acceptable  spice  input  (see  sim2spiee,  pspice  and  spcpp  ). 

Mextra  creates  four  new  files,  basenameXag^  basename^X,  basenamejim.  and  basenamejut^. 
After  mextra  finishes  it  is  a  good  idea  to  read  the  Jog  file.  This  contains  general  information 
about  the  extraction.  It  has  a  count  of  the  number  of  transistors  and  the  number  of  nodes, 
and  it  contains  messages  about  possible  errors.  The  ,al  file  is  a  list  of  aliases  which  can  be  used 
by  esim.  The  Jiodcs  file  is  a  list  of  node  names  and  their  GIF  locations  listed  in  GIF  format.  It 
can  be  read  by  eifplot  to  make  a  plot  showing  the  circuit  with  the  named  nodes  superimposed. 
The  form  of  this  cifplot  command  is: 

clfplot  basename  JSoAta  basenamejtit 

The  .stm  file  is  the  circuit  description  for  use  with  simulation  programs  and  electrical  rule 
checkers.  The  format  of  the  Jlm  file  is  described  in  the  man  page  slmfUc(S). 

Names 

Mextra  uses  the  GIF  label  construct  to  implement  node  names  and  attributes.  The  form  of  the 
GIF  label  command  is  as  follows: 

94  tutme  x  y  [layer]; 

This  command  attaches  the  label  to  the  mask  geometry  on  the  specified  layer  crossing  the 
point  (x,  y).  If  no  layer  is  present  then  any  geometry  crossing  the  point  is  given  the  label 

Mextra  interprets  these  labels  as  node  names.  These  names  are  used  to  describe  the  ^racted 
circuit.  'When  no  name  is  given  to  a  node,  a  number  is  assigned  to  the  node.  A  label  may 
contain  any  ASGII  character  except  space,  tab,  newline,  double  quote,  comma,  semi-colon, 
and  parenthesis.  To  avoid  confiict  with  extractor  generated  names,  names  should  not  be 
numters  or  end  in  ’#ii’  where  a  is  a  number. 

A  problem  arises  when  two  nodes  are  given  the  same  name  although  they  are  not  connected 
electrically.  Sometimes  we  want  these  nodes  to  have  the  same  names,  other  times  we  don’t. 
This  frequently  happens  when  a  name  is  ^>ecified  in  a  cell  which  is  repeated  many  times.  For 
instance,  if  we  define  a  shift  register  cell  with  the  input  marked  ’SRin’  then  when  we  create 
an  8  bit  shift  register  we  could  have  8  nodes  names  ’SRin’.  If  this  happens  it  would  appear  as 
though  all  8  of  the  shift  register  cells  were  shorted  together.  To  resolve  this  the  extractor 
recognixes  three  different  types  of  names:  locals  global,  and  unspecified.  Any  time  a  local 
name  appears  on  more  than  one  node  it  is  appended  with  a  unique  suffix  of  the  form  ’#ii’ 
where  n  is  a  number.  The  numbers  are  assigned  in  scanline  order  and  starting  at  0.  In  the 
shift  register  example,  the  names  would  be  ’SRin#0’  through  ’SRin#7’.  Global  names  do  not 
have  suffixes  appended  to  them.  Thus  unconnected  nodes  with  global  names  will  appear  con¬ 
nected  after  extraction.  (The  -g  causes  the  extractor  to  append  unique  suffixes  to  uncon¬ 
nected  nodes  with  the  same  global  name.)  Names  are  made  local  by  ending  them  with  a  sharp 
sign,  Names  are  global  if  they  end  with  an  exclamation  mark,  T.  These  terminating  char¬ 
acters  are  not  considered  part  of  the  name,  however.  Names  which  do  not  end  with  these 
characters  are  considered  unspecified.  Unspecified  names  are  treated  similar  to  locals.  Multi¬ 
ple  occurrences  are  appended  with  unique  suffixes.  By  convention,  unspecified  names  signify 
the  designer’s  intention  that  this  name  is  a  local  name,  but  is  connected  to  only  one  node.  It 
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is  illegal  to  have  a  name  that  is  declared  two  different  types.  The  extractor  will  complain  if 
this  is  so  and  make  the  name  local. 

It  makes  no  difference  to  the  extractor  if  the  same  name  is  attached  to  the  same  node  several 
times.  However,  if  more  than  one  name  is  given  to  a  node  then  the  extractor  must  choose 
which  name  it  will  use.  Whenever  two  names  are  given  to  the  same  node  the  extractor  will 
assign  the  name  with  the  highest  type  priority,  global  being  the  highest,  unspecified  next,  local 
lowest.  If  the  names  are  the  same  type  then  the  extractor  takes  the  shortest  name.  At  the 
end  of  the  Jog  file  the  extractor  lists  nodes  with  more  than  one  name  attached.  These  lines 
start  with  an  equal  sign  and  are  readable  by  tsim  so  that  it  will  understand  these  aliases. 


Attributes 

In  addition  to  naming  nodes  mextra  allows  you  to  attach  attributes  to  nodes.  There  are  two 
types  of  attributes,  node  attribytes ,  and  trmsittor  attributes .  A  node  attribute  is  attached  to  a 
node  using  the  CIF  94  construct,  in  the  same  way  that  a  node  name  is  attached.  The  node 
attribute  must  end  in  an  at-sign,  More  than  one  attribute  may  be  attached  to  a  node. 
Mextra  does  not  interpret  these  attributes  other  than  to  eliminate  duplicates.  For  each  attri* 
bute  attached  to  a  node  there  appears  a  line  in  the  jiaa  file  in  the  following  form: 

A  node  attribute 

Node  is  the  node  name,  and  attribute  is  the  attribute  attached  to  that  node  with  the  at-sign 
removed. 

Transutor  attributes  can  be  attached  to  the  gate,  source,  or  drain  of  a  transistor.  Transistor 
attributes  must  end  in  a  dollar  sign,  *$*.  To  attach  an  attribute  to  a  transistor  gate  the  label 
most  be  placed  inside  the  transistor  gate  region.  To  attach  an  attribute  to  a  source  or  drain  of 
a  transistor  the  label  must  be  placed  on  the  source  or  drain  edge  of  a  transistor.  Transistor 
attributes  are  recorded  in  the  transistor  record  in  the  Jlaa  file. 

Traaristors 

For  each  transistor  found  by  the  exractor  a  line  is  added  to  the  Jla  file.  The  form  of  the  line 

is: 

type  gate  source  drain  iength  width  x  y 
g^attributes  %=attributes  d=attrUnttes 

Type  can  be  one  of  three  characters,  V  for  enhancement,  ’d’  for  depletion,  or  ’u’  for  unusual 
implant.  (  Unusual  implant  refers  to  transutors  which  are  only  partially  in  an  implanted  area. 
It  will  be  necessary  to  write  a  filter  to  replace  these  transistors  with  the  appropriate  model  in 
tenns  of  enhacement  and  depletion  transistors.)  Gate,  source,  and  drain  are  the  gate,  source, 
and  drain  nodes  of  the  transistors.  Length  and  width  are  the  channel  length  and  width  in  CIF 
units.  X  and  y  are  the  x  and  y  coordinates  of  the  bottom  left  comer  of  the  transistor.  Attri¬ 
butes  is  a  comma  separated  list  of  attributes.  If  no  attribute  is  present  for  the  gate,  source,  or 
drain,  the  g*,  s«,  or  d«  fields  may  be  omitted. 

The  extractor  guesses  the  length  and  width  of  a  transistor  by  knowing  the  area,  perimeter, 
and  length  of  diffusion  terminals.  For  rectangular  transistors  and  butting  transistors  the 
reported  length  and  width  is  accurate.  For  transistors  with  comers  or  for  unusually  shaped 
transistors  the  length  and  width  is  not  as  accurate. 

It  is  possible  to  design  a  transistor  with  three  or  more  diffusion  terminals.  The  extractor  con¬ 
siders  these  ns  funny  transittors.  They  are  entered  in  the  .aim  file  in  the  form: 

ttype  gate  node!  nade2  ...  nodeN  xtoc 
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The  T  is  followed  by  the  type  :  ’d*  or  V.  Node!  ...  nodeN  are  the  diffusion  terminal  nodes. 

As  with  any  circuit  with  transistors,  any  circuit  with  T  transistors  must  be  run  through  a 
hlter  replacing  each  of  the  funny  transistors  with  the  appropriate  model  in  terms  of  enhance¬ 
ment  and  depletion  transistors. 


Capacitance 

The  iilni  file  also  has  information  about  capacitance  in  the  circuit.  The  lines  containing  capa¬ 
citance  information  are  of  the  form: 

C  Hodel  node!  cap-valiu 

cap-vaiue  is  the  capacitance  betweens  a  node  and  substrate  is  in  femto-farads.  Capacitance 
values  below  a  certain  threshold  are  not  reported.  The  default  threshold  is  SO  femto-farads. 

Transistor  capacitances  are  not  included  sinee  most  of  the  tools  that  work  on  the  jim  file  cal¬ 
culate  them  from  the  width  and  length  information. 

The  capacitance  for  each  layer  is  calculated  separately.  The  reported  node  capacitance  is  the 
total  of  the  layer  capacitances  of  the  node.  The  layer  capacitance  is  calculated  by  taking  the 
area  of  a  node  on  that  layer  and  multiplying  it  by  a  constant.  This  is  added  to  the  product  of 
the  perimeter  and  a  constant.  The  default  constants  are  given  below.  Area  constants  are  in 
femto-farads  per  square  micron.  Perimeter  constants  are  femto-farads  per  micron. 


Layer 

Area 

Pe 

metal 

0.03 

OjO 

metal2 

0J015 

OO 

poly 

OjOS 

OjO 

diff(n) 

0.10 

0.1 

diff(p) 

0.10 

0.1 

poly/diff 

0.40 

OJO 

Poly/diffusion  capacitance  is  calculated  similar  to  layer  capacitance.  The  area  is  multiplied  by 
constant  and  this  is  added  to  the  perimeter  multiplied  by  a  constant.  Poly/diffusion  capaci¬ 
tance  is  not  threshold,  however. 

The  -•  option  supresses  the  calculation  of  capacitance,  and  instead,  gives  for  each  node  in  the 
circuit  the  area  and  perimeter  of  that  node  on  the  diffusion,  poly,  and  metal  layers.  The  lines 
containing  this  information  look  like  this: 

L  node  metal2Area  metalTPerim  metaiArta  metalPerim  polyArea  polyPerim  diffArea  diffPerim 
diffpArea  diffpPerim 

Node  is  the  node  name,  x  y  is  the  position  of  a  point  on  the  node.  Currently  this  is  always  *0 
O’.  meialTArea  through  diffpPerim  are  the  area  and  perimeter  of  the  metal2,  metal,  poly, 
diffttsion(n),  and  diffusion(p)  layers  in  user  defined  units.  (In  addition  the  -o  option  causes 
transistors  with  only  one  terminal  to  be  recorded  in  the  Jla  file  as  a  transistor  with  source 
connected  to  drain.) 

//  the  network  is  being  extracted  from  the  xif  file  we  suggest  the  node  capacitance  not  be  com- 
pitted  by  mextra.  Rather  the-a  option  should  be  used.  This  puts  the  burden  of  computing  node 
capcitance  on  the  programs  presim  and  sim2spice2.  We  feel  this  is  advantageous  because 
presim  and  sim2spice2  are  filter  programs  linked  directly  to  the  type  of  simulation  that  is  to  be 
done.  This  will  hopefully  reduce  some  of  the  confusion  associated  with  calibration. 

Changlnt  Dcfaolt  Values 

As  part  of  its  start  up  procedure  mextra  reads  two  files:  /usr/vlsibin/xadre  and  then  a  search 
for  the  first  .cadre  from  the  current  directory  (.)  to  the  the  user’s  home  directory  is  made. 
Mextra  reads  these  files  to  set  up  constants  to  be  changed  without  recompiling.  The  keywords 
for  mextra  are  contained  within  the  mextra  environment  of  the  xadrc  file.  Declaration  of 
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environmeatt  in  the  xadre  file  are  described  in  £adrc(S). 

By  defanit,  mezrra  reports  locations  in  CIF  coordinates.  A  more  convenient  form  of  units  may 
be  specified  either  in  the  .cadre  file  or  on  the  command  line.  The  form  of  the  line  in  the 
xadre  file  is: 

oniti  scat* 

where  scale  is  in  centi-microns.  The  user  may  type  in  the  chosen  value  for  the  scale  directly. 
To  set  units  on  the  command  line  use  the  -•  option, 
nwatra  -a  scat*  basename 

The  parameters  used  to  oonqtute  node  capacitance  may  be  changed  by  including  the  following 
commands  in  your  xadre  file. 

arcatocap  layer  vatu* 
perimetartacap  layer  vatu* 

vatu*  is  atto-farads  per  square  micron  for  area,  and  atto-farads  per  micron  for  perimeter. 
layer  may  be  'poly*,  'difl",  'metal*,  *metaI2*,  or  'poly/difl*. 

To  set  the  capacitor  values  to  those  given  in  Mead  and  Conway  the  following  lines  would 
appear  in  the  xadre  file: 
areatocap  poly  40 
areatoeap  diff  100 
areatocap  metal  30 
areatocap  poly/diff  400 
perimetertocap  poly  0 
perimetertocap  diff  0 
perimetertocap  diff  0 
perimetertocap  metal  0 
perimetertocap  poly/diff  0 

The  threshold  for  reporting  capacitance  may  be  set  in  the  xadre  file  with  the  following  line. 

capthreahoid  value 

A  negative  value  sets  the  threshold  to  infinity. 

Mexira  knows  of  two  technologies,  nMOS  and  cMOS  p-well.  NMOS  is  assumed  by  default. 
To  set  the  technology  to  cMOS  p-wetl,  include  the  following  line  in  your  xadre  file: 

tech  coMS-pw 

nLES 

'/xadre 

hoseiuMirxif 

baseuame^ 

basenamelog 

baseuainejiodca 

basenamejim 

SMMALaO 

powest(l.vlsi),  pq}ice(l.vUi),  spcpp(l.vlsi),  sim2spice(l.vlsi),  q)ice(l.vlsi),  drc(l.vlsi),  erc(l.vlsi) 
caesar(cadl), 

cadrc(cad5),  simfile(l.vlsi). 

AUTHOR 

Dan  Fitzpatrick  (UCB) 
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MODinCAnONS 

(UW/NW  VLSI  Consortium,  University  of  'Wa^ington) 

BUGS 

Accepts  manhattan  simple  CIF  only,  use  elfplot  -O  to  convert  complicated  CIF-  For  unusu* 
ally  shaped  transistors  the  UW/NW  modified  mextra  should  be  used,  otherwise  values  will  be 
quite  inaccurate.  The  modified  mextra  will  either  yield  accurate  values  or  a  'reasonable'  guess, 
depending  on  the  complexity  of  the  unusual  transistor.  The  modified  wtextra  will  tell  you 
when  the  output  values  are  only  best  estimates.  The  length/width  ratio  for  unusually  shaped 
transistors  may  be  inaccurate.  This  is  true  for  snake  transistors.  Attributes  for  funny  transis¬ 
tors  are  not  recorded.  Node  attributes  are  ignored  unless  the  -o  switch  is  present. 
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NAME 

mtp  -  Multiple  Time-series  Plot  for  simulator  output 
SYNOPSIS 

mtp  bthaitior'fiU  directivt-/iU  plot-fUt 
raOKSIPTION 

Mtp  plots  the  output  of  rtd  and  spiet  simulations  on  the  Printronix  line  printer.  Behavior-file 
is  the  rid  or  tpiee  output  file.  direetive-fUe  is  a  'qiecification  file'  for  the  plot,  and  plot-file  is 
an  output  file  to  contain  the  plot  suitable  for  printing  on  the  Printronix  line  printer. 

The  use  of  mtp  involves  the  following  steps: 

1.  Generate  a  behavior  file. 

If  you  are  using  rid,  the  directive 
openplot  “behaviorflleT 

will  cause  the  changes  to  all  traced  nodes  to  be  written  to  belu»ler-fUe  in  addition  to 
being  written  to  the  terminal.  Quotes  are  necessary  if  the  file  name  has  any  punctua¬ 
tion  in  it. 

The  RNL  directive 
closeplot 

will  terminate  the  behavior  file.  If  the  entire  rid  session  is  to  be  recorded  closeplot  is 
not  required,  as  the  file  will  be  terminated  when  rid  exits. 

If  you  are  using  spice,  a  behavior  file  may  be  specified  as  the  third  positional  parame¬ 
ter  of  the  spice  command.  Behavior  records  will  be  put  on  this  file  for  aU  nodes 
specified  on  the  Spice  PLOT  directive. 

2.  Generate  a  plot  file  from  the  behavior  file  using  mtp. 

The  plot  is  sent  to  the  Printronix  printer  using  the  Unix  command 
Ipr  -1  plot  file 

The  contents  of  behavior  file  are  interpreted  with  the  help  of  direetivefile.  For  the  basic  pur¬ 
pose  of  plotting  the  output  of  rid  or  spice,  only  a  few  directives  need  be  supplied: 

1.  start  time 

Tells  mtp  when  to  start  plotting.  If  not  supplied  time  defaults  to  0.  Data  is  skipped  on 
the  behavior  file  until  an  event  is  found  whose  time  is  greater  than  or  equal  to  the 
start  time. 

2.  step  time 

Tells  mtp  when  to  stop  plotting.  A  stop  value  must  be  specified.  If  the  stop  time  is 
greater  than  the  time  of  the  last  event  on  the  behavior  file,  the  plot  will  be  concluded 
with  the  last  event. 

3.  Male  time 

Tells  mtp  the  number  of  time  units  per  inch.  The  default  value  is  lOOOD.  Because  the 
time  unit  used  by  rid  for  behavior  file  output  is  1.0  nanosecond,  this  value  will  pro¬ 
duce  plots  of  rid  output  having  a  scale  of  IB  microsecond  per  inch. 

4.  logical  signal 

This  is  used  primarily  for  plotting  rnl  output.  To  select  signals  A,  B  and  C  for  plot¬ 
ting  in  logical  format  the  directives  would  be 

logical  A 
logical  B 
logical  C 
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S.  analog  signal  height 

Analog  format  is  required  when  dealing  with  spice  output  because  spice  produces 
floating  point  values  rather  than  logic  levels.  The  height  in  inches  of  each  trace  must 
be  specified.  To  select  node  voltages  for  nodes  1, 2  and  3  for  plotting  in  analog  format 
the  necesary  directives  might  be 

analog  V(l)  OJ 
analog  V(2)  0.S 
analog  V(3)  0.S 

The  order  of  selection  directives  in  the  file  determines  the  order  of  the  traces  on  the  plot. 
The  first  signal  selected  is  plotted  closest  to  the  time  axis.  A  maximum  of  20  signals  may  be 
selected  on  a  given  plot. 

Spaces  are  used  to  separate  the  fields  of  a  directive  line.  Blank  lines  or  lines  starting  with  # 
are  ignored.  Directives  are  case  insensitive  except  for  signal  names. 

EXAMPLE 

The  following  example  uses  mtp  to  plot  the  behavior  of  a  10  bit  counter,  cntrlOnet,  shown 
here  in  netlist  format: 

;  net  file  for  10-bit  counter 

;  half  adder  made  from  gates 
(macro  half  adder  (a  b  s  c) 

(local  hi  h2  h3) 

(nand  (hi  2  16)  a  b) 

(nand  (h2  2  16)  a  hi) 

(nand  (h3  216)bhl) 

(nand  (s  2  16)  h2  h3) 

(invert  c  hi) 

) 

;  one  cell  of  a  counter 
(macro  cell  (in  out  Cin  Cout) 

(local  cl  c2  c3) 

(invert  cl  in) 

(trans  phil  cl  c2) 

(invert  c3  c2) 

(half_adder  c3  Cin  out  Cout) 

(trans  phi2  out  in) 

) 

:  declare  global  node  names 
(node  count  c  in  out  phil  phi2) 

;  carry-in  to  first  significant  bit  controls  counting  action 
(connect  count  ci)) 

;  generate  the  counter 
(repeat  i  1  10 
(capacitance  out.i  1.234) 

(cell  in.i  outi  c.(l-  i)  cJ) 

) 
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The  ml  control  file.  cntrlOJ.  is  as  follows: 

;  RNL  initialization  file  for  10  bit  ripple-carry  counter 

(load  ’uwstdi”) 

(load  ”uwsimi^ 

(read-network  'cntrlOO 

;  (setq  report-form  nil)  This  turns  off  the  report  generator 

(setq  incr  1000) 

:  bind  symbols  to  node  names 

(chflag  '(phil  phi2  out.lO  out^  out  J  out.7  out.6 
out J  out.4  out3  out2  out.l)) 

(defun  init  (dummy) 

(1  ’(count  in.l  in  2  in  J  in.4  in  J 
injfi  in .7  in^  in.9  in.l0)) 

(I  ’(phi2)) 

(h  ’(phil)) 

(step  incr) 

(I  ’(phil)) 

(step  incr) 

(x  ’(in.l  in2  inJ  in.4  inJ 
inii  in.7  in.8  in.9  in. 10)) 

(h  ’(Phi2)) 

(step  incr) 

(I  ’(phi2)) 

(step  incr) 

(h  ’(count)) 

(wr-report) 

'done 

) 


(defvec  ’(bit  bout  out. 10  out.9  out  J  out.7  outfi 
out  J  out.4  out3  out2  out.l)) 

(defvec  ’(dec  dout  out .10  out.9  out 3  out.7  out.6 
out3  out.4  out3  out2  out.l)) 
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(def'rqMrt  ’('10  bit  counter  current  state*  newline  *  ' 
count  (vec  bout)  (vec  dout))) 


Generate  the  behavior  for  the  counter  using  rnl 

netlist  cntrlOJiet  cntrlO^im 
presim  cntrlOaim  cntrlO 
ml  cntrlOJ 

init 

openplot  *cntrlOxvl* 


c30 

exit 


#  initialize  the  counter 

#  open  the  behavior  file 

#  (^vl  stands  for  event  list) 

#  run  30  clocks 

#  exit  ml 


Generate  the  plot. 

mtp  cntrlOxvi  cntrlO.mtp  cntrl0.plt 
Ipr  cntrl0.pU 

The  file  cntrlOmtp  could  contain  the  following: 

start  Of) 
stop  20000.0 
scale  lOOOi) 
logical  phil 
logical  phi2 
logical  out.l 
logical  outJ 
logical  outJ3 
logical  out.4 
logical  outJ 

The  start  and  scale  directives  are  not  necessary  but  are  included  for  the  purpose  of  illustra¬ 
tion.  Although  not  required,  these  directives  typically  preceed  the  signal  selection  directives 
in  the  file. 

When  mtp  runs  it  lists  the  contents  of  the  directive  file  on  the  terminal  and  reports  progress 
with  the  following  messages: 

Previous  output  cntrl0.plt  removed 
Select  and  preproceu  input  data 
Sort  preproces^  events 
Generate  the  plot 
Rasterize  for  the  Printronix 
mtp  complete,  plot  file  is  cntrlO.pIt 
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The  'Rasterize  for  the  Printronix*  message  marks  the  beginning  of  the  longest  step  in  the  pro¬ 
cess  which  typically  takes  about  a  minute  under  moderate  system  loads. 

Mip  creates  scratch  files  named  fortJ,fort2,for$J,fort.4.  and  fort. 7.  If  any  of  these  files  are 
present  when  mtp  is  invoked  it  wilt  exit  with  an  error  message.  This  can  happen  if  mtp  is 
aborted  before  having  time  to  clean  up  the  scratch  files.  If  this  happens  the  scratch  files  can 
be  cleaned  up  with  the  Unix  command 

rm  fort  .[12347] 

mv  AW 

ml(l.vlsi)  spice(l.vlsi). 

User’s  Guide  to  RSL  VLSI  Ocsi0i  Tools  Reference  Mannalt  UW/NW  VLSI  Consortium, 
University  of  Washington,  (Christopher  Terman,  MIT  Laboratory  for  Computer  Science). 

SPICE  User’s  Guide,  VLSI  Dcsl0i  Tools  Reference  Mannal,  UW/NW  VLSI  Consortium, 
University  of  Washington.  (A.  Vladimirescu  ei  al~,  15  Oct.  1980) 

AITTHOR 

William  Beckett  (UW) 
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NAME 

mult  -  geuerate  a  cmos  multiplier  layout  (version  IjO). 

SYNOPSIS 

mull  [optloHs]  caesarnamt 
DESCRIPTION 

Uult  is  a  module  generation  program  for  static  cmoa  multiplier  circuits.  The  layout  is  pro¬ 
duced  in  'caesai'  format,  tiidi  requires  a  number  of  caesar  cells  with  names  of  the  form 
mult«xa  to  exist  in  directory  Jet.  These  should  be  copied  from 
$UW_VLSI_TOOLS/lib/geaerators/muIt  prior  to  running  mult.  The  generated  layout  is  output 
in  directory  Vea  in  caesar  cells  with  names  of  the  form  *caesamame'*jca.  Mult  is  a  efl-based 
program  and  therefore  also  produces  *.bd  files.  'Caesamame'  may  not  begin  with  the  string 
*mult*. 

The  option!  are  as  follows: 

-g  Makes  the  left  side  horizontal  bus  ground.  This  is  the  default. 

-as  mbit! 

Sets  the  number  of  bits  in  the  multiplicand  operand.  Mbit!  must  be  in  the  range  3  to 
32.  The  default  is  3. 

^n  nbit! 

Sets  the  number  of  bits  in  the  multiplier  operand.  Nbitt  must  be  in  the  range  3  to  32. 
The  default  is  3. 

-p  Pjttring 

labels  the  propduct  output  bits  with  labels  •P_string(f ,  T.stringr,  ’T_string2',  etc. 
with  *P.  stringO*  attached  to  the  Isb.  These  labels  appear  on  the  right  side  and  the  bot¬ 
tom  side  of  the  layout.  The  default  is  *p*. 

-s  Makes  the  number  representation  signed  (two's  complement).  This  is  the  default. 

Makes  the  number  representation  unsigned. 

-V  Makes  the  left  side  horizontal  bus  Vdd. 

-a  X_string 

labels  the  multiplicand  input  bits  with  labels  'X_string(f ,  'X_stringr,  ''X_string2*,  etc. 
with  *X_string(r  attached  to  the  Isb.  These  labels  appear  on  the  top  side  of  the  layout. 
The  default  is  *x*. 

-y  Y_!tring 

labels  the  multiplier  input  bits  with  labels  'Y_string(r,  'Y_stringr,  ’'Y_string2*,  etc. 
with  ‘'Y_string(r  attached  to  the  Isb.  These  labels  appear  on  the  left  side  of  the  lay¬ 
out.  The  default  is  'y*. 

FILES 

JczJcaetarnameoja 

Jealcaesarnameu.bd 

JczlmulfXM, 

SEE  ALSO 

caesar(CADl),  cfl(S.vlsi) 

AUTHORS 

Wayne  E.  Winder 
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NAME 

netUst  -  a  simple  network  description  language  for  VLSI  circuits 
SYNOPSIS 

netllst  tnfite  [oHtfUe]  [-o]  [-Ueck]  [-aunits]  {-an)  [-dn^]  [-CR,m] 

DESCSIPTION 

Netlist  requires  an  input  file  with  any/all  extensions  on  the  command  line.  An  optional  output 
file  can  be  specified.  Additional  options  are  described  below; 

-e  Uses  old  input  format.  Size  specifications  are  taken  to  be  length/width  rather  than 

width/length. 

-Ueeh  Uses  teek  in  the  technology  portion  of  the  units/tech  line  at  the  beginning  of  the 
simulation  file  produced  (Default  is  nmos). 

-ojiiuir  Sets  the  number  of  centi-microns  per  lambda  to  umts  (Default  is  2S0).  Warning: 

The  "units”  set  by  this  option  appear  in  the  comment  line  of  the  jim  file.  This 
value  is  not  used  by  PRESIM  and  does  not  influence  an  RNL  simulation. 

-sn  Uses  number  a  as  initializer  for  internal  node  names;  useful  when  you  want  to 
mergp  the  results  of  separate  neilist  runs. 

-dn,  R  Sets  the  default  width  to  r  and  length  to  ri  for  depletion  devices.  The  defaults  are 
r-8  and  ri-2. 

-SR,  R  Similar  to  -d  except  for  enhancement  devices.  The  defaults  are  r=2  and  ri=2. 

-1r.  r  Similar  to  -d  except  for  intrinsic  devices.  The  defaults  are  r-2  and  m=2. 

-Ir,  r  Similar  to  -d  except  for  low*power  devices.  The  defaults  are  r=2  and  ri-2. 

-pR,  R  Similar  to  -d  except  for  p^hannel  devices.  The  defaults  are  r«2  and  m»2. 

In  addition,  if  node  alias  records  (=  nodel  node2  ...)  are  declared  using  'connect'  (See  netlist 
reference  documents)  they  appear  in  a  file  with  the  name  "basename-al".  The  basename  is  the 
input  file  name  minus  its  last  extension. 

NetUst  is  a  macro-based  language  for  describing  networks  of  sized  transistors.  Names  in  netlist 
refer  to  nodes,  which  presumably  get  interconnected  by  tbe  user  through  transistors.  Macros 
for  describing  transistors  can  be  found  in  the  NETUST  User's  Guide.  In  addition  to  transistor 
macros  netlist  provides  macros  that  allow  the  user  to  set  node  capacitance,  specific  node  delays 
(in  tenths  of  nanoseconds),  and  transistor  threshold  voltages.  The  user  may  also  define  his 
own  macros. 

The  load  command  uses  the  environment  variable  KNU^ATH  (default 
.:$UW_VUI_TOOLS/lib/rnl).  See  the  NETUST  User's  Guide  for  details. 

SEE  ALSO 

preiiRi(l.vlsi),  rR/(l.vlsi), 

NETUST  User's  Guide.  VLSI  Dcstgn  Tools  Reference  Manual,  UW/NW  VLSI  Consortium, 
University  of  Washington, 

AUTHOR 

Christopher  Terman  (MIT) 
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NAME 

pads  -  generate  a  cmos  padframe  layout  (version  1:0) 

SYNOPSIS 

pads  cattwrnamt  <  frame_spec 
DESCRIPTION 

pads  is  a  module  generation  program  for  a  MOSIS  3  micron  cmos  padframe  layout.  This  gen¬ 
erator  uses  leaf  cells  derived  from  the  MIT  pads  received  from  MOSIS.  The  leaf  cells  and  the 
layout  that  is  produced  are  in  *caesar”  format.  Pads  looks  for  caesar  leaf  cells  with  names  of 
the  form  pad*£a  in  the  directory  Jca.  These  should  be  copied  from 
$UW_VLSI_TOOLS/Iib/generators/pads  prior  to  running  pods.  Pads  also  reads  in  a  frame  spec 
file  from  the  home  directory  (not  7ca).  The  frame_spec  file  definition  is  provided  in  the  text 
that  follows.  The  generated  layout  cells  (composition  cells)  appear  in  directory  7ca  with 
names  caesarname«xa.  Pads  is  a  cfl-based  program  and  therefore  also  produces  v.bd  files. 
'Caesarname'  may  not  begin  with  the  string  'pad*. 

There  are  no  options. 

FRAME.SPEC 

The  frame  specification  is  a  text  file  made  up  of  one  frame  specifier  followed  by  several  pad 
specifiers.  Tliese  records  are  terminated  with  *;'  and  may  cross  line  boundaries.  Individual 
fields  within  records  should  not  cross  line  boundaries.  The  syntax  is  ’c-like’;  comments  may  be 
placed  anywhere  with  the  /«  ...  */  convention. 

The  frame  specifier  is  made  up  of  a  type  specifier  followed  by  an  optional  connection  layer 
specifier.  The  type  specifier  is  one  of  C28_46x34,  C40_^x68,  C40_69x68,  C64_69x68, 
C64_79x92,  or  C84_79x%  (the  first  number  indicates  the  number  of  pins  on  the  frame,  the 
second  and  third  numbers  give  the  x  and  y  dimensions  of  the  entire  frame  in  hundreds  of 
microns).  The  connection  layer  specifier  indicates  what  material  connects  the  individual  pad 
circuitry  to  the  interior  of  the  chip  (across  the  quard  ring).  This  specifier  may  be  METAL2 
or  POLY.  Default  is  POLY. 

The  pad  specifiers  are  used  to  determine  the  type  of  circuitry  to  place  on  specific  pad  sites. 
Pad  specifiers  are  made  up  of  pin  number,  pad  type,  and  optional  label  and  connection 
specifiers. 

The  pin  number  is  an  integer  between  1  and  the  number  of  pins  for  the  frame  specified  (see 
above).  For  the  28  pin  frame,  pin  number  1  is  in  the  middle  of  the  right  side  of  the  frame. 
For  the  40  and  64  pin  frames,  pin  number  1  is  immediately  above  the  middle  of  the  right  side 
of  the  frame.  For  the  84  pin  frame,  pin  number  1  is  the  rightmost  pin  on  the  top  of  the 
frame.  Pin  numbering  procedes  counterclockwise  in  all  cases. 

The  pad  type  is  one  of  padlvdd  (power),  padlgnd  (ground),  padlin  (input),  padlout  (output), 
padlttl  (ttl  output),  pad  Its  (tri  state  output),  padlbin  (buffered  input),  padlbit  (buffered  ttl 
input)  or  padlsp  (frame  spacer  -  never  required). 

The  optional  label  specifiers  are  of  the  form  ’BP  =  label’,  XI  =  label’,  ’L2  =  label’  and  ’L3  = 
label’.  BP,  LI,  L2  and  L3  indicate  where  on  the  pad  circuitry  to  place  the  label;  on  the  bond¬ 
ing  pad,  on  the  leftmost  connection  on  the  bottom  of  the  pad  circuitry  (when  viewed  with 
bonding  pad  on  top),  second  from  left  and  third  from  left,  respectively.  ’Label’  is  any  string 
beginning  with  a  letter  and  containing  only  non-special  characters.  Special  characters  include 
’;’  and  ’/’.  Special  characters  can  be  included  in  strings  by  placing  double  quotes  arcund 
the  string  and  preceding  the  special  character  with  the  backslash  character.  For  details  of 
what  connection  connects  to  what  portion  of  the  pad  circuitry,  view  the  appropriate  circuit 
from  padl*.ca  using  caesar.  The  connections  should  be  annotated  with  local  labels  to  avoid 
ambiguity.  Not  all  connections  appear  on  all  pads. 
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The  optional  connection  specifier  indicates  which  connection  to  the  interior  is  to  receive  a 
contact,  after  crossing  the  guard  ring.  This  specifier  is  of  the  form  ’CN  =  layer’,  where  N  is  1, 
2  or  3  and  is  identified  as  above.  ’Layer*  is  one  of  METAL,  POLY,  or  METAL2.  Default  is 
METAL.  If  the  layer  is  the  same  as  the  input  connection  material  (specified  in  the  first  record), 
no  contact  is  placed.  If  different,  a  contact  is  placed.  POLY  may  not  be  routed  to  METAL2 
and  vice-versa. 

RESTRICTIONS 

Pins  may  not  be  assigned  more  than  once.  Only  those  pins  required  need  be  assigned. 

In  ceratin  comers  of  certain  frames,  tristate  pad  connections  do  not  cross  the  quard  ring. 

In  the  28,  40,  and  64  pin  frames,  pin  1  should  be  vdd  or  blank.  In  the  84  pin  frame,  pin  10 
should  be  vdd  or  blank. 

Each  frame  must  include  at  least  one  VDD  pad  and  one  Ground  pad.  These  pads  may  only 
connect  to  the  interior  with  METAL. 

HLES 

Jcalcaesarname»£ti 

JczJc(uiarnam£*bd 

JczJpad*£ii 

$UW_VLSI_TOOLS/src/examples/pada/input 
(for  a  frame_spec  example) 

SEE  ALSO 

cfl(S.vIsi) 

AUTHORS 

Wa)me  E.  Winder 
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NAME 

peg  <-  finite  state  maehine  compiler 
SYNOPSIS 

p*f  f  -•  J I  -<  H  ni*  j 

DESCRIPTION 

Peg  (/’LA  Equation  Generator)  is  a  finite  state  machine  compiler.  It  translates  a  high  level 
language  description  of  a  finite  state  machine  into  the  logic  equations  needed  to  implement 
the  state  machine  design.  Peg  uses  the  Moore  model  for  finite  state  machines,  in  which  out¬ 
puts  are  strictly  a  function  of  the  current  state.  Input  is  read  from  the  named  file  or  from 
atdin  if  no  file  is  specified. 

A  set  of  equations  is  generated  on  standard  output.  The  equations  are  in  the  eqn  format  used 
by  eqntott.  Output  from  peg  may  be  piped  directly  to  mkpla  or  tpla  thus: 

peg  iefUe  I  eqntott  I  mkpla  -i-o-yn  >foutfiIe 
peg  i/tfile  I  eqntott  I  tpla  -c  -s  Bcis  -I  -O  -o  outfile 

Either  of  these  command  lines  generates  a  PLA  implementation  of  the  finite  state  maehine  in 
the  file  ourfiterif.  In  the  above  command  line  for  mkpla,  n  must  be  replaced  by  the  integer 
number  of  state  bits  generated  for  the  fsm  by  peg. 

The  PLA  will  have  clocked,  dynamic  latches  on  all  inputs  and  outputs.  From  left  to  right,  the 
PLA  inputs  and  outputs  are  the  fsm  inputs,  fsm  state  inputs,  fm  state  outputs,  and  fsm  out¬ 
puts.  The  mkpla  result  will  feed  back  n  state  bits  from  the  PLA  outputs  to  the  PLA  inputs; 
however,  if  tpla  is  used  then  the  feedback  lines  must  be  manually  added  to  the  resulting  cir¬ 
cuit. 

Peg  options  have  the  following  meanings. 

-t  Generate  a  truth  table  for  the  fsm  in  the  file  pegjummary. 

-s  Print  summary  information  in  the  file  pegjummary. 

PROGRAM  STRUCTURE 

A  peg  program  is  composed  of  a  list  of  input  signal  names,  a  list  of  output  signal  names,  and  a 
list  of  state  descriptions,  in  that  order.  The  input  and  output  lists  are  optional. 

Inpots 

An  input  signal  list  consists  of  the  keyword  INPUTS  and  a  list  of  fsm  input  signal  names,  ter¬ 
minated  with  a  semicolon.  Every  input  list  must  have  at  least  one  input.  If  the  fsm  has  no 
inputs,  this  statement  is  omitted.  PLA  inputs  will  have  the  left-to-right  ordering  specified  in 
the  INPUTS  list. 

Ontpnts 

A  list  of  output  signal  names  begins  with  the  keyword  OUTPUTS  and  is  terminated  with  a 
semicolon.  PLA  outputs  wilt  have  the  ordering  specified  in  the  OUTPUTS  list. 

State  List 

The  remainder  of  a  peg  program  consists  of  a  list  of  state  definitions.  A  state  definition  has 
the  form 

[  ttate-name  ] ;  [  ASSERT  signal-list  ;  ]  [  eornrol ;  ] 

There  is  at  most  one  ASSERT  statement  per  state  definition.  Asserted  output  signals  are  set 
to  1.  Signals  that  are  not  asserted  have  value  0. 

There  is  at  most  one  control  statement  per  state  definition.  Control  may  be  one  of 
IF  [  NOT  ]  input  THEN  state-name  [  ELSE  state-name  ] 
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GOTO  ttatt-namt 

CASE  (input-signal-lisi)  teltetert  ENDCASE  [dtfault\ 

Each  case  selector  spedfiea  the  next-state  for  a  particular  set  of  values  of  the  CASE  input  sig¬ 
nals.  Case  selectors  ate  lines  of  the  form 

{  0  I  1  I  ?  }-!■  a>  statt-namt 

If  no  control  is  specified-  by  omitting  the  ELSE  clause  from  an  IF.  by  specifying  a  CASE  with 
no  default,  or  by  omitting  control  information  entirely-  next  state  defaults  to  the  next  sequen¬ 
tial  state  on  the  state  list.  The  default  next  state  is  undefined  for  the  last  state  in  the  pro¬ 
gram.  The  q>ecial  state  name  LOOP  specifies  that  the  next  state  is  the  same  as  the  current 
state. 

Comments  may  appear  at  any  location  in  a  peg  program.  They  begin  with  a  double  dash,  *-*. 
and  terminate  at  the  end  of  the  line  on  whi^  they  appear. 

React  Logic 

There  are  two  ways  of  handling  fsm  initialization.  If  the  keyword  RESET  appears  as  one  of 
the  input  signals,  then  the  fsm  will  jump  to  the  first  state  on  the  state  list  when  the  signal 
RESET  is  asserted  high.  Alternatively,  the  user  may  force  a  junq>  to  the  first  state  on  the  state 
list  by  adding  logic  to  the  PLA  state  outputs  to  pull  all  of  the  state  output  lines  bw  when  a 
reset  is  desired. 

Esnmpio 

The  following  peg  program  illustrates  a  variety  of  features: 

-Decode  inputs  a,  b,  and  c  into 
-0, 1, 2, 3,  or  'other'. 

INPUTS:  RESET  Select  a  b  c; 

OUTPUTS: 

FoundO  Foundl  Found2  Founds  FoundOther; 


Start: 

-This  is  the  reset  state 

IF  NOT  Select  THEN  LOOP; 

CASE  (a  b  c)  -Second  state 

0  0  0  «>  Zero; 

0  0  1  »>  One; 

0  1 0  *>  Two; 

Oil  »>  Three; 

ENDCASEa>  Other; 

Zero: 

ASSERT  FoundO;  GOTO  Start; 

One: 

ASSERT  Foundl;  GOTO  Start; 

Two: 

ASSERT  Found2;  GOTO  Start; 

Three: 

ASSERT  Founds;  GOTO  Start; 

Other: 

ASSERT  FoundOther;  GOTO  Start; 

SEE  ALSO 

mkpla(CADl).  tpMCADI).  eqntoit(CADl) 

Gordon  Hamachi,  Designing  Finite  State  Machines  with  Peg 
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FILES 

peg  nummary  summary  information  file 
AUTHOR 

Gordon  Hamachi 

BUGS 

The  parser  quits  after  the  first  error  is  found. 


3rd  Berkeley  Distribution 


1(V1S/S2 


3 


PLA2NET(1.VLSI) 


VLSI  CAD  Tools  Manual 


PLA2NET(1.VLSI) 


NAME 

pla2net  •  generate  aetlist  macro  from  truth  table  of  pla 

SYNOPSIS 

plalaai  batttiamt 

OESCEIPTION 

plaZntt  generates  a  netlist  macro  using  the  truth  table  definition  for  a  pla  as  an  input.  This 
truth  table  may  have  been  obtained  using  PEG  and  EQNTOTT.  pla2iut  expects  that  a  file 
named  'basenaaM.tt*  is  in  the  current  directory:  if  this  is  not  the  case  an  error  message  will  be 
generated.  The  output  of  pla2net  will  be  stored  in  a  file  named  'basenameM^'. 

The  macro  defined  in  the  'bateHorntM/t’  file  looks  u  follows: 

(macro  basename  (output  input)  where: 

the  basename  is  identical  to  the  basename  in  the  eommmand  line  of  pla2net; 

•  output  is  an  outputvector.  numbered  from  left-to^right  as  in  the  truth  table  and  a  lay¬ 
out  generated  with  tpla  starting  with  output.l; 

•  input  is  an  inputvector,  number  from  left-to-right  as  in  the  truth  table  and  a  lay-out 
generated  with  tpla  starting  with  input  .1. 

Note:  When  designing  pla*s  for  sequential  state  machines  with  PEG.  the  innermost  inputs 
and  outputs  of  the  pla  will  be  the  least  significant  bit.  The  state  register  inputs  and 
outputs  must  be  wired  accordingly  (mirror  and  shift  numbering  of  input  vector  in  the 
netlist  description  for  the  top  level  sequential  state  machine,  which  includes  the 
feedback  register,  is  necessary). 

INPUT  nut 

bascnamc.tt 

OUTPUT  FILE 

bascaaiiM.net 

SEE  ALSO 

Manual  entries  for  PEG,  EQNTOTT. 

AUTHOB 

Henriecus  Koeman,  John  Fluke  Mfg.  Co.,  Inc. 

BUGS 

The  current  version  only  supports  emos  technologies.  The  source  code  can  easily  be 
modified  for  other  technologies. 
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NAME 

presim  -  a  aetlist  preprocessor  for  the  ml  VLSI  circuit  simulator 

SYNOPSIS 

prcdm  ii^Ut  outfUe  [configfile\  [-f]  [-^ile^n]  \preMist, voltage] 

DESCRIPTION 

Presim  converts  the  Mm  file  into  a  binary  file  to  be  used  by  ritl. 

The  parameters  and  options  are  as  follows: 

iirfile  A  net  list  file  that  must  include  any/all  extensions; 

outfile  An  output  filename  must  be  specified  on  the  command  line; 

coirfigfUe  (optional)  A  file  to  set  lambda  and  RC  parameters  for  nodes  and  transistors  in 
the  netlist  (see  the  presim  user’s  guide  for  descriptions  of  the  parameters  and  syn¬ 
tax). 

•g  Suppresses  the  sum-of-products  formation.  This  may  be  desired  if  you  think 

sum-of-products  is  formed  wrong  otherwise  the  advantages  of  the  transistor  and 
node  reduction  make  this  option  unattractive. 

-cflle,  min  Writes  a  list  of  node  names  and  capacitances  to  the  specified  file.  Only  capaci¬ 
tances  larger  than  min  will  be  included. 

-t/ile,  min  Writes  a  list  of  transistors  and  RC  values  to  the  specified  file  -  there  are  two 
entries  for  each  transistor.  The  R’s  come  from  the  size  of  the  transistor,  C's 
from  the  source/drain  capacitance.  Only  RC  values  larger  than  min  will  be 
included. 

-preslat,  voltage 

^ovides  a  worse-case  estimate  of  the  circuit  power  consumption  by  ■w“»"fng 
that  all  the  puUups  (DEP  or  LOWP  devices  with  drain  «Vdd)  are  all  on  simul¬ 
taneously.  Voltage  specifies  the  supply  voltage, 

Presim  also  attempts  to  open  the  file  basenameM,  where  basename  is  defined  as  the  input  file 
name  minus  its  last  extension.  It  is  non-fatal  for  this  file  to  be  absent. 

SEE  ALSO 

PPESIM  User's  Guide,  VLSI  Dcsigp  Tools  Rcfercnco  Manual,  UW/NW  VLSI  Consortium, 
University  of  Washington,  (Christopher  Terman,  MIT  Laboratory  for  Computer  Science). 

AUTHOR 

Christopher  Terman  (MIT) 

BUGS 

Propagation  of  X  state  information  for  cmos  circuits  in  rnl  is  unreliable  if  the  gate  reduction 
in  presim  is  performed.  If  this  information  is  required,  suppress  gate  reduction  with  the  -g 
option  in  presim. 


UW/NW  VLSI  Release  2 


1 


DRAFT 


PRESTO  (l.VLSI) 


VLSI  CAD  Tools  Manual 


PRESTO ( l.VLSI) 


NAME 

presto  -  combinational  logic  minimuation  program 

SYNOPSIS 

presto 

DESCRIPTION 

Presto  is  an  efficient  eombinational  logic  minimization  program.  This  program  not  only 
reduces  the  number  of  produet  terms,  increases  the  number  of  don’t  care  inputs,  but  also 
reduces  the  number  of  the  output  connections.  Therefore,  this  program  is  very  useful  to  pla 
designers. 

Input  is  taken  from  standard  input.  Output  goes  to  standard  output. 

An  example  of  typical  input  is  as  follows: 
i4 
jo2 
J 

.p4 
10x1 11 
OOQx  lx 

nil  01 
0101  10 
jC 

The  integer  after  'i'  is  the  number  of  input  variables.  The  integer  after  *jO*  is  the  number  of 
output  variables.  The  integer  after  *.p*  is  the  number  of  input  product  terms.  *i*  is  optional 
for  input  listing.  There  is  another  option  "4“  for  intermediate  results. 

In  the  input  part,  1  means  logic  level  1, 0  means  logic  level  0,  x(or  *)  means  don’t  care.  In  the 
output  part,  1  means  that  the  term  is  connected  to  the  output,  0  means  that  this  term  is  not 
connected  to  the  output,  and  x(or  •)  means  that  the  output  doesn’t  care  whether  this  term  is 
connected  or  not.  *.e*  means  the  end  of  the  input  file.  When  there  is  a  format  error  in  the 
input  file,  the  program  will  give  the  message:  'INPUT  FORMAT  ERRORf  and  abort  the  job. 

AUTHOR 

Sheng  Fang 
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NAMK 

papice  -  prepare  an  input  file  for  the  Spice  circuit  simulator 
SYNOPSIS 

pspkt  [-*rm]  [-Mils)  (-d  (-a  model/ile]  [-a  expf'de\  basename 

desoiiption 

Pspie*  is  a  shell  script  for  preparing  SpiM  input  from  information  from  several  sources.  Pspice 
runs  sim2spie*  to  convert  from  a  basenatujlm  format  circuit  description  to  a  Spice-compatible 
description  and  modifies  the  tim2spiet  node  label  translation  table  to  be  acceptable  Spice  com¬ 
ments.  It  then  runs  spcpp  to  translate  a  paeudo-Spice  formatted  file  that  contains  symbolic 
node  labels  to  a  Spice-acceptable  file.  Finally,  pipte*  concatenates  the  circuit  description  file, 
the  translation  table,  a  file  of  untranslated  Spice  input,  and  the  translated  Spice  input  into  a 
single  file  named  baseHomejpela.  This  file  is  usually  an  acceptable  Spice  input  file.  The 
optional  parameters  can  be  used  to  cause  parts  of  this  proceu  to  be  skipped. 

The  options  and  parameters  are: 

-nsals  Suppresses  the  execution  of  the  sim2spiee  step. 

-ns  Indicates  that  the  files  created  in  intermediate  steps  are  to  be  deleted. 

-d  d^tfiU  Specifies  a  file  to  be  used  as  a  timispice  definitions  file. 

modetfiU  Specifies  a  file  that  contains  Spice  input  that  is  to  be  included  (untranslated)  in 
the  final  output.  It  is  intended  that  modelfiU  name  a  file  containing  Spice 
JdODEL  cards  as  well  as  other  Spice  commands  that  are  independent  of  the 
particular  circuit  being  modeled. 

-e  txpfilt  Specifics  a  file  that  contains  pseudo-input  for  Spice.  Spcpp  will  interpret  strings 
in  cxpfiU  that  are  bracketed  by  ’<  *  and  ’>  ’  as  node  names  to  be  translated 
into  spice  node  numbers  using  the  translation  table  {basenamejumte)  created 
by  sim2spice.  Lines  containing  bracketed  tokens  are  converted  into  Spice  com¬ 
ments.  It  is  intended  that  expfUe  contain  Spice  commands  that  describe  the 
experiment  to  be  simulated  on  the  circuit.  Ilie  ability  to  use  mnemonic  node 
names  makes  the  preparation  of  Spice  input  much  easier  and  it  means  that  the 
description  of  the  experiment  need  only  be  specified  once,  even  if  the  circuit  is 
modified  and  reextracted.  If  expfile  is  not  specified  then  spcpp  is  not  executed. 

bsuenasne  Specifies  the  base  name  for  the  files  describing  the  circuit.  If  sim2spice  is  run 
then  a  file  named  basename  Mm  must  exist.  If  simZspice  is  not  run  then  the  files 
basenasne  names  and  basename  apdrn  must  exist. 

nLES 

basenasne  Jim  circuit  description  infnit  to  sinCspiee 

defsfUe  optional  simispice  defs  input 

basenasnejiuaga  modified  sim2splce  translation  table  output.  This  is  read  by  spcpp  (*) 
basesiasne spice  sim2spice  output  Spice  format  circuit  element  definitions  (•) 

modelflle  optional  Spice  .MODEL  commands  to  be  included  in  basename  spetn 

expfile  input  to  spcpp  containing  pseudo-spier  commands  describing  the  experiment 

to  be  simulated 

basesiasnespes,  translated  output  from  spcpp  (•) 

basesusnespdn  The  Spice  input  deck  created  by  concatenating  hatenomr  jpicc, 
baseneune .namrs,  model/ile,  and  basenasnesptx 

Note:  Files  marked  (•)  are  deleted  by  the  -ms  option. 

SEE  ALSO 

sim2spice(l.vlsi),  spcpp(l.vlsi) 
spice(l.vlsi) 
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meztra(l.vlst),  dfplot(CADl) 

AUTBOB 

Robert  Fowler  (UW/NW  VLSI  Consoittum.  University  of  Washington) 

DIAGNOSTICS 

The  error  messages  are  intended  to  be  seif  explanitory.  Note  that  sim2spice  and  spcpp  produce 
their  own  error  messages. 

BUGS 

The  command  line  is  long  enough  to  tempt  a  user  to  call  p$piee  from  yet  another  shell  script. 
A  better  way  to  do  this  is  to  set  up  an  alias  for  pspice  with  the  commonly  used  options  already 
set. 
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NAME 

ml  -  timing  and  logic  simulator  for  VLSI  circuits 

SYNOPSIS 

ml  [emdfUe] 

DESCRIPTION 

RiU  (NetLisp)  is  a  timing  logic  simulator  for  digital  NMOS  circuits  with  a  lisp-like  command 
interpreter.  It  has  also  been  used  with  many  CMOS  circuits  with  some  success.  The  Rat 
User’s  Guide  discusses  some  of  the  limitations  found  in  simulating  CMOS  circuits.  To  use  rnl, 
one  needs  a  Jim  file  for  the  circuit  to  be  simulated.  This  can  be  derived  from  the  mask  file 
(e.g.,  CIF)  or  developed  using  netlist.  a  program  that  processes  textual  schematics. 

One  must  first  convert  the  Jtm  file  to  a  network  file  suitable  for  use  by  rni.  To  do  this  run 
presim: 

presim  filename  Jim  netfile  [configjarams\ 

which  converts  the  file  filename  jim  into  netfile,  a  binary  file  for  rnl.  (see  Presim  User’s  Guide 
for  information  on  the  various  configuration  parameters. 

The  optional  cmdfile  is  the  file  rnl  initially  reads  for  user  input.  Usually  one  prepares  a  com¬ 
mand  file  that  loads  one  or  more  library  files  containing  RNL  function  definitions  and  reads  in 
the  network  from  netfile.  As  simulation  proceeds,  user  defined  functions  developed  for  test¬ 
ing  the  circuit  can  be  added  to  the  command  file.  At  a  minimum  the  command  file  should 
contain  the  commands 

(load  'uwstdj*) 

(load  'uwsimi^ 

(road-network  ’netfile^ 

When  using  the  load  command  both  netlist  and  rnl  search  the  current  directory  and  then  any 
directories  specified  in  the  environment  variable  RNLPATH.  The  value  of  RNLPAJH  defaults 
to  tWW y LSI yooisilibirnl.  Read-network  does  not  use  RNLPATH.  Netfile  must  be  pro¬ 
duced  by  presim.  When  the  end-of-file  is  reached  in  the  command  file,  input  is  taken  from 
stdin.  Commands  and  formats  to  be  used  are  given  in  the  RNL  User’s  Guide. 

The  top  level  of  rni  is  a  simple  loop: 

(1)  read  command  from  current  input; 

(2)  evaluate  command,  performing  specified  actions; 

(3)  print  the  result  and  loop  back  to  (1). 

The  following  is  a  list  of  the  objects  that  rnl  knows  about 

numbers  -  signed  integers.  (16  bits  on  PDPlls,  24  bits  on  VAXen,  28  bits  on  PDPlOs). 

-  floating  point. 

strings  sequences  of  characters  enclosed  in  quotes  (”).  Useful  as  constants  for  file 
names,  print  statements,  etc.  Special  characters  can  be  introduced  into  the 
strings  by  using  the  backslash  escapes: 

^n’  newline 

^r'  return 

\t’  tab 

Nooo’  ascii  code  *ooo*  where  ooo  are  octal  digits 

symbols  variable  names.  Any  sequence  of  characters  that  isn't  a  number,  string,  or  some 
special  character  -  starting  symbols  with  a  letter,  followed  by  more  letters, 
oumben,  and  punctuation  is  usually  a  safe  bet. 

nodes  an  electrical  node. 
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lists  a  sequence  of  objects  enclosed  in  parentheses.  Standard  LISP  syntax  applies, 

including  dot  notation.  The  empty  list  ”()'  is  also  called  "nii*. 

smbrt  primitive,  or  built-in.  functions  (like  +). 

The  functions  are  listed  by  application  area.  The  areas  are: 

•  arithmetic  functions 

-  predicates 

•  list  functions 

-  I/O  functions 

•  miscellaneous  functions 

•  special  forms 

-  network/simulation  functions 

•  functions  defined  in  'uwsimi* 


SEE  ALSO 

iutUst(ly\Mi),  pr«tiR(Lvlsi),  siiirfUe(5ylsi) 

RNL  User's  Guide.  VLSI  Dcsi0a  Toels  Rcfcrcaca  Manual.  UW/NW  VLSI  Consortium,  Univer¬ 
sity  of  Washington,  (Christopher  Terman,  MIT  Laboratory  for  Computer  Science). 

AUTHOR 

Christopher  Terman  (MTT) 

BUGS 

User  defined  macros  with  the  same  name  as  a  node  in  the  net  list  puts  rnl  into  an  infinite 
loop. 

Propagation  of  X  state  information  for  cmos  circuits  is  unreliable  if  the  gate  reduction  in 
presim  is  performed.  If  this  information  is  required,  suppress  gate  reduction  with  the  -g 
option  in  presim. 
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NAME 

nilec  -  Compile  design  rules  for  Lyra 

SYNOPSIS 

raise  (-te]  rules 

DESCRIPTION 

Ridte  is  a  shell  script  with  the  following  processing  steps: 

i)  The  actual  Lyra  rule  compiler  is  invoked  to  translate  the  symbolic  rule  description, 
rulesx,  to  lisp  code,  ruIesJ. 

ii)  The  lisp  compiler,  Lisa,  is  invoked  to  compile  ridesA  to  rules jo 

iii)  rutesju  is  loaded  into  Lyrapr<ao  to  generate  an  executable  lisp  Lyra,  rules. 

iv)  The  intermediate  files  rides  A,  and  rules  m  are  deleted. 

The  following  options  are  supported: 

-I  (load  only)  No  compilation  is  done.  Previously  compiled  rules,  rulesju,  are  loaded  into 
Lyraproto  to  generate  an  executable  Lyra,  rides.  This  option  is  useful  mainly  at 
Berkeley,  where  Lyraproto  changes  frequently. 

-o  (save  object)  Nameju  is  not  removed.  Enables  ’raise  *1  rules’  in  the  future. 

FILES 

'cadybin/rulec  -  rules  shell  script. 

*cad/lib/lyra/Rulecl  -  lisp  rule  compiler 
*cad/tib/lyra/Lyra.proto  -  Lyra  sans  compiled  rules  code. 

*cad/lib/lyra/«x  -  standard  rulesets. 

*cad/lib/lyra/DEFAULTS  ••  gives  default  rulesets  for  Caesar  technologies. 

SEE  ALSO 

Lyra  (CAD) 

List  (1) 

AUTHOR 

Michael  Arnold. 
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NAMK 


simlspice  -  convert  from  mextra  format  to  Spice  (circuit  simulator)  format 


SYNOPSIS 

■Iml^plcc  [-d  basenamejtm 
DESCRIPTION 

SinQspiee  reads  the  basenameMm,  hoMitam*  modes  and  basenamejl  files  created  by  mextra  and 
creates  a  Spice  readable  circuit  description,  basename  .eptta.  Spice  requires  node  numbers  and 
siitdspiee  generates  a  translation  table  basename  Jt»mm  which  shows  the  mextra  nodelabel 
corresponding  to  a  given  node  number. 

The  user  can  ^ecify  his/her  own  translation  table  by  using  the  -d  option,  where  d^s  is  a  file 
of  definitions.  A  definition  can  be  used  to  set  up  equivelences  between  node  names  and 
Spice  node  numbers.  The  form  of  this  type  of  definition  is: 

set  simjuxme  spieejutmber  [recA] 

The  tech  field  is  optional.  In  nMOS.  a  4>ecial  node,  ‘BULK*,  is  used  to  represent  the  substrate 
node.  For  cMOS,  two  special  nodes,  ’NMOS*  and  TMOS*,  represent  the  substrate  nodes  for 
the  ’n*  and  *p’  transistors,  repectively.  For  nample,  for  nMOS  the  aim  node  ‘GND* 
corresponds  to  Spice  node  0,  ‘Vdd’  corresponds  to  Spice  node  1,  and  ‘BULK*  corresponds  to 
Spice  node  2.  The  d^s  file  for  this  set  up  would  look  like  this: 
set  GND  0  nmoa 
set  Vdd  2  nmos 
set  BULK  3  nmoa 

A  definition  also  allows  you  to  set  a  correspondence  between  Jtm  transistor  types  and  and 
Spice  transistor  types.  The  form  of  this  definition  is: 
daf  simjrans  spieejrans  (tech) 

Again,  the  tech  field  is  optional.  For  nMOS  these  definitions  would  look  as  follows: 
del  e  ENMOS  nmoa 
def  d  DNMOS  nmos 

Definitions  may  also  be  placed  in  the  ‘.cadre*  file,  but  the  definitions  in  the  deft  file  overrides 
those  in  the  ‘xadre*  file. 

Sim2spice  also  reads  ‘N*  lines  generated  by  mextra  with  the  -o  switch.  In  order  to  compute 
capacitances  from  this  it  must  have  a  set  of  convenion  factors  between  length/area  and  capaci¬ 
tance.  These  are  specified  in  the  sim2spice  section  of  ‘.cadre’  file  in  exactly  the  same  format  as 
in  the  mextra  section  of  the  ‘xadre*  file  (see  mextra). 

The  program  has  been  extended  so  that  a  comment  line  beginning  with  'I-'  is  interpreted  as 
an  KttT  xlm  style  node  equivalence  line. 

To  create  a  complete  Spice  input  file  it  is  necessary  to  append  applicable  Spice  model  descrip¬ 
tions  as  well  as  the  user’s  Spice  simulation  commands  to  the  batenamejplee  file. 

It  is  recommended  in  most  cases  that  the  user  run  pspice  rather  than  sim2spiee.  Ptpiee  incor¬ 
porates  the  features  of  tim2spice  but  will  in  addition  allow  the  user  to  build  all  of  the  Spice 
input  file  in  one  step.  Ptpiee  also  incorporates  the  features  of  tpepp. 
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SEE  ALSO 

meztra(l.vbi),  spice(l.vlsi),  pspice(l.vtst).  spcpp(l.vlsi) 

AUTHOR 

Dan  Fitzpatrick  (UCB) 

MODIFICATIONS 

Neil  Soiffer  (UCB)  ~  cMOS  fixes. 

Rob  Fowler  (UW/NW  VLSI  Consortium.  University  of  Washington)  ~  node  equivalence  han¬ 
dling  and  misc.  bug  fixes. 

BUGS 

The  only  pre-defined  teehnologies  are  *nmos*  and  ‘cmos-pw’.  Only  one  definition  file  is 
allowed. 

Warning:  for  nMOS  circuits  the  node  names  'ENMOS'  and  *ONMOS”  are  preempted  by 
sim2spice  as  synonyms  for  'BULK*. 

The  node  equivalence  handling  is  not  completely  general.  New  nodes  can  be  added  to 
equivalence  classes,  but  classes  cannot  be  merged.  This  is  detected  and  an  error  message  is 
produced. 
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NAME 

simscope  -  view  time-series  of  simulator  output. 


SYNOPSIS 

shucepe 

DESCRIPTION 

simscope  is  designed  to  display  signal  output  produced  by  RNL  or  SPICE  on  a  Tek  410S  or  a 
GP-19  graphics  terminal.  To  make  hardcopies,  you  ne^  a  Tek  4695  printer  (or  compatible 
hardcopy  device)  in  conjunction  with  the  Tek  4105  graphics  terminal.  Any  program  that 
might  periodically  interfere  with  the  display,  notably  sysline,  should  be  switched  off. 

General  Rales  for  URng  simscope: 

1.  Names  to  be  entered  in  response  to  simscope'%  requests  may  contain  alpha  as  well  as  numer¬ 
ical  characters. 

2.  Numbers  to  be  entered  in  response  to  simscope's  requests  may  be  fixed-point  or  fioating- 
point  numbers  (the  latter  format  is  also  referred  to  as  scientific  notation).  Examples  of 
fixed-point  numbers  are  123,  3J5,  +45000,  etc.  Examples  of  numbers  in  scientific  notation 
are  3.5e4,  0J33e-9,  O.le-9,  +244.5e05,  etc.  Numbers  may  not  be  negative  (negative  time 
scales,  times,  and  positions  do  not  make  sense  to  simscope). 

3.  While  entering  a  name  or  a  number,  characters  typed  erroneously  may  be  deleted  with 
either  the  RUBOUT  key  (CONTROL-H  is  equivalent)  or  the  BACKSPACE  key 
(DELETE  on  some  keyboards). 

4.  All  numbers  displayed  by  simscope  are  in  scientific  notation.  The  mantissa  consists  of  one 
digit,  a  decimal  point,  another  six  digits,  the  *e'  indicating  the  exponent,  the  sign  for  the 
exponent,  and  two  digits  for  the  exponent. 

5.  After  reading  a  behavior  file,  simscope  uses  the  same  time  units  as  those  used  in  the 
behavior  file.  These  are  nanoseconds  (ns)  in  RNL-generated  files  and  seconds  (s)  in 
SPICE-generated  files. 

6.  Indeterminate  RNL  signals  (state  *X0  *te  displayed  with  a  logic  level  of  03. 


How  to  Start  and  Exit  simscope 

Work  with  simscope  is  most  convenient  if  you  change  to  the  directory  that  contains  the 
behavior  file  you  want  to  view.  Being  in  that  directory,  simply  enter  simscope.  simscopecoma 
up  with  a  greeting  display.  The  window  begin  and  end  times  are  set  to  0  (B  ==  ODOOOOO+00 
and  E  =  OBOOOOO+OO)  and,  consequently,  the  time  scale  is  0  (T  =  0.000000+00),  too.  The 
mode  (see  below)  is  set  to  fixed-time-scale  mode.  The  Y-scale,  in  units  per  division,  is  set  to  1 
(Y  »  lDOOOOO+00). 

Below  these  indicators  the  menu  is  displayed,  followed  by  the  request  that  you  hit  a  key  indi¬ 
cating  the  menu  function  you  wish  to  select.  Valid  keys  are:  f,  n,  b,  e,  t,  y,  c,  d,  s,  r,  and  q, 
all  of  which  may  be  entered  as  capitals  (with  the  SHIFT  key).  Each  letter  represents  the  first 
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letter  of  the  corre^xmding  menu  function  (see  below).  After  you  press  any  of  these  keys,  the 
corresponding  function  is  immediately  activated  •  no  RETURN  is  necessary. 

To  exit  simseopt,  press  the  *q*  key  (Quit). 


sinueope  Functions 
File 

This  function  serves  two  purposes.  First,  it  provides  the  following  information  about  the  file 
presently  loaded: 

name  of  present  behaviour  file 

file  begin  time  (the  time  of  the  first  signal  entry  in  the  file) 
file  end  time  (the  time  of  the  last  signal  entry  in  the  file) 
for  each  signal  in  the  file: 

first  change  (the  time  of  the  first  entry  of  the  signal  in  the  file) 

last  change  (the  time  of  the  last  entry  of  the  signal  in  the  file) 

y-position  (the  vertical  position  of  the  signal  in  the  display;  a  number  between 
1  and  99,  1  is  the  lower  end  of  the  window,  99  is  the  upper  end  of  the  win* 
dow). 

name  (the  signal’s  name) 

The  second  purpose  of  the  File  function  is  to  facilitate  the  loading  of  a  different  file.  If  you 
press  'y*  (yes)  in  reply  to  the  function  prompt.  File  will  ask  you  for  the  name  of  the  new 
behaviour  file  you  want  to  load.  Any  other  key  will  terminate  the  File  function,  display  all 
signals,  and  return  you  to  the  menu.  If  you  enter  a  name,  the  corresponding  file  is  read. 
Reading  the  behaviour  file  may  take  awhile,  during  which  time  the  cursor  may  flash  at  various 
positions  on  the  screen  (hence  the  message:  Heading  file.  Please  wait.  Don’t  worry  if  the  cur¬ 
sor  fluhes  a  bit.*). 

Nodes 

You  will  be  asked  for  a  node  name  (default  is  the  node  last  entered),  simeope  then  asks 
whether  you  want  to  display  the  node’s  signal  or  delete  the  node’s  signal  from  the  display. 
or  just  RETURN  means  display,  •  means  delete  from  display  (the  y-position  of  the  signal  is 
set  to  zero).  Next  simscope  asks  for  the  position  (vertically)  in  the  window.  Enter  99  for  the 
very  top  of  the  window,  1  for  the  bottom  of  the  window,  any  number  between  1  and  99  for  an 
intermediate  position.  (One  division  on  the  y-scale  is  equivalent  to  S  positional  units.) 
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Reposition  i  signal  by  entering  its  name  with  Nodes,  then  enter  the  desired  new  position. 

Assuming  that  you  normally  want  to  change  more  than  one  signal  in  a  row,  file  information 
(as  in  the  File  function)  is  displayed  after  you  enter  a  y-position,  providing  you  with  a  sum¬ 
mary  of  the  information  on  all  nodes  if  the  behaviour  file. 

Use  the  Display  function  to  display  the  signals. 


BCflB 

Sets  the  window  begin  time  (”B  »  *  at  left  side  of  the  window). 

In  fized-time-scale  mode,  a  change  of  the  window  begin  time  moves  the  window  (whose  time 
width  remains  unchanged)  across  the  file. 

In  fixed-window-end  mode,  a  change  of  the  window  begin  time  expands  or  contracts  the  win¬ 
dow  in  a  ”rubber-band-Iike*  fashion. 

End 

Sets  the  window  end  time  (*£  »  *  at  right  side  of  the  window). 

The  time  scale  will  be  readjusted  automatically  to  be  consistent  with  the  new  window  end 
time. 

The  window  begin  time  is  not  affected. 

Setting  the  window  end  time  will  switch  over  to  fixed-window-end  mode.  In  this  mode 
changes  to  the  window  begin  time  will  not  affect  the  window  end  time,  but  will  readjust  the 
time  scale.  You  can  use  End  for  switching  to  fixed-window-end  mode  (without  actually  chang¬ 
ing  the  window  end  time)  by  confirming  the  present  (default)  value  of  the  end  time.  To  do 
that  press  V,  then  just  hit  B£TURN. 


T-sealc 

Sets  the  time  scale  of  the  window  (”T  »  '  below  the  window). 

The  window  end  time  will  be  readjusted  automatically  to  be  consistent  with  the  new  time 
scale. 

The  window  begin  time  is  not  affected. 

Setting  the  time  scale  will  switch  over  to  fixed-time-scale  mode.  In  this  mode,  changes  to  the 
window  begin  time  will  not  affect  the  time  scale,  but  will  readjust  the  window  end  time.  You 
can  use  T-scale  for  switching  to  fixed-time-scale  mode  (without  actually  changing  the  time 
scale)  by  confirming  the  present  (default)  value  of  the  scale.  To  do  that  press  *t*,  then  just  hit 
RETURN. 


Y-seate 

Sets  the  vertical  scale  in  units  per  division  (*Y  *  ”  below  ”8  »  *).  The  default  is  1,  which  is  a 
good  value  for  RNL.  The  vertical  extent  of  SPICE  signals  is  usually  larger,  however  (for 
example  5  Volts,  i.e.  S  units).  Increasing  the  Y-scale  allows  you  to  fit  more  of  the  larger  sig¬ 
nals  on  the  screen  without  overlapping. 
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Copy 

To  make  hardcopies,  you  need  a  Tek  410S  and  t  Tek  469S  printer  (or  compatible  device).  (If 
you  activate  the  Copy  function  on  a  GP-19  terminal,  you  will  get  the  message:  'Use  a  Tek  4105 
terminal.  (You  can  also  use  MTP).  Hit  any  key  to  continue.*) 


Display 

All  signals  with  a  y-position  greater  than  1  are  displayed.  Use  this  function  to  display  the  sig¬ 
nals  after  you  have  made  changes  for  any  node  (deletion,  positioning  or  repositioning),  or  if 
you  want  to  refresh  the  display  for  any  reason. 


Save 

All  parameters  determining  the  particular  display  state  are  saved  for  later  retrieval.  'Save* 
first  ajks  you  for  a  name  of  the  file  in  which  you  want  to  keep  the  present  state.  It  then  saves 
in  this  file  the  present  behaviour  file  name,  window  begin  time,  time  scale,  window  end  time, 
mode  (1  for  fiaed-time-scale  mode,  0  for  fixed-window-end  mode),  and  the  names  of  all 
displayed  signals  with  their  positions  on  the  y-axis. 

Saved  states  can  be  restored  easily  with  the  Retrieve  function.  You  may  conveniently  con¬ 
sider  the  names  of  'Save'  files  as  markers  (possibly  with  short  names  like  1,  2,  3 . or  al, 

registers.  Load  10,  etc.),  which  can  be  'jumped  to*  with  the  Retrieve  function. 


Rstrlevs 

Retrieve  is  the  function  used  to  restore  a  previously  saved  di^lay  state.  You  are  asked  for 
the  name  of  the  file  containing  the  state  to  be  restored.  If  the  state  you  want  to  restore 
belongs  to  a  behaviour  file  different  from  the  one  on  which  you  are  working  presently,  then 
the  new  behaviour  file  is  read  (this  may  take  some  time). 

Quit 

This  function  terminates  simscope  and  returns  you  to  the  UNIX  shell. 


Ths  OSS  of  simacopt  to  display  RNL  or  SPICE  results  Involves  the  following  steps: 

1.  Generate  a  behavior  file. 

(a)  If  you  are  using  RNL,  the  directive 
openplot  "bthavior-fUiT 

will  cause  the  changes  to  all  traced  nodes  to  be  written  to  behmlor-fUt  in  addition  to 
being  written  to  the  terminal.  Quotes  are  necessary  if  the  file  name  has  any  punctua¬ 
tion  in  it. 
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The  RNL  directive 
cloeeplot 

will  terminate  the  behavior  file.  If  the  entire  RNL  session  is  to  be  recorded  eloteplot  is 
not  required,  as  the  file  will  be  tenninated  when  RNL  exits. 

(b)  If  you  are  using  SPICE,  a  behavior  file  may  be  specified  as  the  third  positional  param¬ 
eter  of  the  SPICE  command.  Behavior  records  will  be  put  on  this  file  for  all  nodes 
specified  on  the  SPICE  PLOT  directive. 

2.  Use  the  F  (File)  function  of  simaeope  to  load  the  behavior  file  and  get  information  on  the 
signals  stored  in  it. 

Use  simaeope'*  other  menu  functions  to  display  any  signal  in  the  file  on  any  position  (vert¬ 
ically)  on  the  screen,  change  the  time  scale  (window  sixe)  and  window  position.  After  you 
have  analyzed  and  positioned  your  signals,  make  a  hard-copy,  if  desired. 

EXAMPLE  (PrtpsratiM  et  a  BsksviMr  PEs  with  ENL) 

The  following  example  uses  aimacope  to  display  the  behavior  of  a  10  bit  counter,  cntrlOnet, 
shown  here  in  netlist  format: 

:  net  file  for  10-bit  counter 

;  half  adder  made  from  gates 
(macro  half  adder  (a  b  s  c) 

(local  hi  h2  h3) 

(nand  (hi  2  16)  a  b) 

(nand  (h2  2  16)  a  hi) 

(nand  (h3  2  16)  b  hi) 

(nand  (s  2  16)  h2  h3) 

(invert  c  hi) 

) 

;  one  ceil  of  a  counter 
(macro  cell  (in  out  Cin  Cout) 

(local  cl  c2  c3) 

(invert  cl  in) 

(trans  phil  cl  c2) 

(invert  c3  c2) 

(half_adder  c3  Cin  out  Cout) 

(trans  phi2  out  in) 

) 

;  declare  global  node  names 
(node  count  c  in  out  phil  phi2) 

;  carry-in  to  first  significant  bit  controls  counting  action 
(connect  count  cD) 

;  generate  the  counter 
(repeat  i  1 10 
(capacitance  out.i  1.234) 
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(cell  ini  outi  c.(l-  i)  ci) 

) 

The  RNL  control  file,  cntrlOJ,  is  as  follows: 

;  RNL  initialization  file  for  10  bit  ripple^arry  counter 

(load  'uwstdJ*) 

(load  *uwsimi*) 

(read-network  'cntrlOJ 

:  (setq  report-form  nil)  This  turns  off  the  report  generator 

(setq  incr  1000) 

;  bind  symbols  to  node  names 

(chflag  ’(phil  phi2  out.lO  out.9  outR  out.7  out.6 
out  J  out.4  out3  out2  out.l)) 

(defun  init  (dummy) 

(1  ’(count  in.l  in2  in2  ia.4  in^ 
inj6  in.7  in^  in.9  in.l0)) 

(I  '(Phi2)) 

(h  ’(Phil)) 

(step  incr) 

(I  ’(Phil)) 

(step  incr) 

(x  ’(in.l  in2  inJ  in.4  in.5 
in.6  in.7  in  .8  in.9  in.lO)) 

(h  ’(phi2)) 

(step  incr) 

(I  ’(phi2)) 

(step  incr) 

(h  ’(count)) 

(wr-report) 

’done 

) 


(defvec  ’(bit  bout  out.lO  out.9  out  J  out.7  out.6 
out J  out.4  out2  out2  out.l)) 
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(defvec  ’(dec  dout  out.lO  out.9  out£  out.7  out^ 
out J  out.4  outJ  oat2  out.l)) 

(def-report  ’(*10  bit  counter  current  state*  newline  *  * 
count  (vec  bout)  (vec  dout))) 


Generate  the  behavior  for  the  counter  using  KNL 

netlist  cntrlOJiet  cntrlOjim 
presim  cntrlO^im  cntrlO 
RNL  cntrlOJ 


init 

#  initialize  the  counter 

openplot  *cntrl0.beh* 

#  open  the  behavior  file 

#  (i>eh  stands  for  network  behavior  file) 

c30 

#  run  30  clocks 

exit 

#  exit  RNL 

SEE  ALSO 

RNL(l.vIsi)  SPICE(l.vIsi),  mtp(l.vlsi) 

SIMSCOPE  User’s  Guide  Release  20  Available  from  the  UW/NW  VLSI  Consortium,  Sieg  Hall, 

FR-3S,  University  of  Washington,  Seattle,  WA  98195 

"User’s  Guide  to  RSL’  *VLS1  Design  Tools  Reference  Manual*,  UW/NW  VLSI  Consortium, 

University  of  Washington,  (Christopher  Terman,  MIT  Laboratory  for  Computer  Science). 

"SPICE  User’s  Guidd',  'VLSI  Design  Tools  Reference  Manual,*  UW/NW  VLSI  Consortium, 

University  of  Washington,  (A.  Vladimirescu  et  at.,  15  Oct.  1980) 

RESTRICTIONS 

1.  In  graphics  mode,  which  is  obviously  required  for  simscope,  the  GP-19  can  display  upper 
case  characters  only,  simscope  Rstill  recognizes,  and  processes  correctly,  lower  case  charac¬ 
ters.  You  have  to  know  which  characters  in  your  file  and  which  node  names  are  upper 
case,  and  which  are  lower  case,  and  enter  them  accordingly.  Otherwise,  simscope  may  tell 
you  that  it  does  not  know  the  name  you  entered.  The  Tek  4105  terminal  does  not  have 
this  problem. 

2.  The  File  function  does  not  recognize  the  *  (tilde)  as  part  of  a  path  name. 

3.  RNL  and  SPICE  write  only  changes  of  signal  levels  to  the  behavior  file.  Therefore,  a 
signal’s  value  before  the  fint  file  entry  is  not  known,  simscope’*  strategy  to  deal  with  this 
situation  is  to  display  this  value  as  indeterminate  (0.5,  X  in  RNL). 

4.  The  number  of  signals  in  a  behavior  file  is  limited  to  20  (17). 
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S.  The  length  of  behavior  files  is  restricted  to  20,000  signal  changes  (iit.  to  20,000  lines). 
This  could  be  extended  easily,  if  need  be. 

BUGS 

1.  In  case  the  number  of  signals  in  a  behavior  file  is  greater  than  20  or  the  behavior  file  con¬ 
tains  more  than  20,000  signal  changes  (i«.  to  20,000  lines),  simscope  crashes. 

2.  The  first  line  of  a  behaviour  file  is  discarded,  because  in  the  case  of  RNL  behaviour  files 
this  line  contains  irrelevant  information  different  from  the  information  of  all  other  lines. 
Therefore,  the  very  first  signal  change  of  a  SPICE  behaviour  file  is  lost.  This  is  not  noti- 
cable  in  most  cases,  however. 

3.  Some  versions  of  SPICE  produce  behaviour  files  that  contain  floating  point  numbers  for¬ 
matted  in  a  non-standard  manner.  Encountering  of  a  non-standard  format  in  the 
behaviour  file  causes  jinueopt  to  crash.  A  typical  case  is  that  a  number  like  *OJOOOe-7*  is 
given  as  *0.  e-7*.  timacop*  recognises  the  first  format  only.  The  behaviour  file  can  be 
mended  easily  by  using  an  editor  to  globally  replace  *.  e*  by  ’JOOOt’. 

These  bugs  will  be  removed  with  the  next  release  of  simseopt. 


AUTHOR 

Rudolf  W.  Nottrott  (UW/NW  VLSI  CONSORTIUM) 
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NAME 

spcpp  -  Spice  (circuit  simulator)  input  pre-processor 
SYNOPSIS 

spcpp  [-c]  [-sn]  [-d/r]  [-1  /name]  [-«  oiuuiuj  tname 
DESCRIPTION 

Spcpp  is  a  program  that  translates  bracketed  text  tokens  in  an  input  file  into  other  text  strings. 
It  is  intended  to  allow  users  of  spice  to  prepare  their  simulation  input  using  mnemonic  node 
names  rather  than  the  numeric  node  numbers  required  by  Spice  commands.  The  program  has 
two  major  modes  of  operation.  If  the  user  does  not  specify  a  file  that  contains  a  translation 
table,  then  spcpp  builds  a  translation  table  itself  numbering  the  tokens  from  zero  as  it 
encounters  them.  Alternatively,  the  user  can  specify  the  name  of  a  file  containing  a  transla¬ 
tion  table  to  be  used.  In  particular,  the  Jiamefl  file  created  by  simZspice  is  usable  as  a  transla¬ 
tion  table  file. 

The  options  snd  parameters  are: 

-c  Indicates  that  the  first  non-whitespace  word  of  each  line  of  the  translation  table  file 

should  be  skipped  over.  This  is  useful  if  your  translation  table  hu  an  asterisk 
in  column  1  cd  each  line  to  allow  it  to  be  read  by  tpicc  as  comments. 

-s*  Indicates  that  n  lines  at  the  beginning  of  the  translation  table  file  should  be  skipped 
over.  If  no  number  is  specified  then  only  the  first  line  of  the  file  is  skipped. 

-d/r  Redefines  the  token  delimitets  to  be  T  and  V’  respectively.  The  default  delimiters 
are  ’<  ’  and  ’>  ’. 

-t  tnauu  Specifies  a  file  that  contains  a  translation  table  (default  is  to  build  a  translation 
table  as  described  above).  Each  line  of  this  file  should  have  at  least  two  non¬ 
whitespace  words  on  it.  If  the  -c  option  is  specified  then  the  first  word  on  each 
line  is  ignored.  The  next  word  is  interpreted  as  a  string  to  be  translated  and  follow¬ 
ing  one  is  interpreted  as  the  taifet  string  into  which  it  is  translated.  Any  subse¬ 
quent  words  on  the  line  are  ignored.  For  Spice  input  preparation  the  target  string 
should  be  a  numeral.  The  -s  option  allows  the  file  to  be  prefaced  by  one  or  more 
lines  that  spcpp  will  ignore. 

-o  oname  Specifies  a  file  into  which  the  output  is  to  be  written.  If  this  option  is  not  used 
then  the  output  is  written  to  irootjspa  where  iroot  is  obtained  by  stripping  away 
any  tags  from  iname. 

iname  Specifies  the  name  of  the  file  to  process. 

A  bracketed  token  is  defined  to  be  a  left  delimiter  character,  zero  or  more  spaces,  a  word  (the 
token)  not  containing  either  right  or  left  delimitets,  zero  or  more  spaces,  and  a  right  delimiter 
character.  Unmatched  delimiter  characters  are  not  allowed  in  any  context.  Bracketed  tokens 
are  not  allowed  to  span  lines.  Tokens  and  the  strings  that  they  translate  into  are  limited  to  be 
at  most  40  characters  each. 

Any  line  that  contains  no  bracketed  tokens  is  simply  copied  from  the  input  to  the  output.  If  a 
line  does  contain  a  bracketed  token  then  the  input  line  is  written  into  the  output  a  Spice  com¬ 
ment  line.  An  output  line  follows  immediately.  If  the  line  is  valid,  then  the  output  line  has 
the  untranslated  parts  immediately  below  the  corresponding  parts  of  the  commented  input 
line  with  the  target  strings  substituted  for  the  bracketed  tokens.  If  an  error  is  detected,  then 
the  output  line  has  a  caret  (**’)  immediately  below  the  point  at  which  the  first  error  is 
detected.  An  error  message  line  then  follows.  Since  the  scanning  of  the  line  is  abandoned 
there  may  be  subsequent  undetected  errors  in  the  remaining  part  of  the  line. 
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Example: 

If  the  following  lines  are  contained  in  the  translation  table  file: 

Vdd  1 
Input  SS 
Output  107 
foo  23 
bar  4S 

then  spcpp  will,  upon  seeing  the  lines: 

^lot  trans  v(<  Input>  )  v(<  Output>  ),  i(<  Vdd>  ) 
v(<  foo>  ),  v(<  bar>  ) 

will  output  the  lines: 

•  ^ilot  trans  v(<  Input>  )  v(<  Output>  )  v(<  Vdd>  ) 

.plot  trans  v(SS)  v(107)  v(l) 

•  +  v(<  foo>  ),  v(<  bar>  ) 

+  v(23).  v(45) 

Note  that  spcpp  correctly  handles  Spice  continuation  cards. 

Note  also  that  the  substitution  process  is  not  recursive.  That  is,  once  a  token  has  been 
translated,  the  translated  string  is  not  rescanned. 

The  usefulness  of  spcpp  for  simulating  a  circuit  extracted  from  a  layout  depends  upon  the  user 
being  able  to  ensure  that  his  mnemonic  node  labels  will  be  retained  through  the  extraction 
process.  The  mexsra  and  simlspict  manual  entries  will  help  with  this. 

Pspice  is  a  shell  script  that  runs  sim2spice  and  spcpp  and  concatenates  several  files  is  useful  for 
preparing  Spice  inputs  from  jIoi  files. 


FILES 

inamt 

irootspcK 

oname 

tname 

SEE  ALSO 

mextra(l.vlsi),  pspice(l.vlsi),  sim2spice(l.^),  simtools(l.vlsi),  spice(l.vlsi), 

SPtCE  User's  Guide.  VLSI  Ocslgti  Tools  Reference  Manual,  UW/NW  VLSI  Consortium, 
University  of  Washington,  (SPICE  Version  2C6  User's  Guide,  A.  Vladimirescu  el  al.,  IS 
October  1980) 

AUTHOR 

Robert  Fowler  (UW/NW  VLSI  Consortium,  University  of  Washington) 

DIAGNOSneS 

The  error  messages  are  intended  to  be  self  explanatory.  If  spcpp  encounters  a  syntax  error  on 
a  line  then  it  suspends  processing  on  that  line  and  writes  it  as  a  Spice  comment  to  the  output 
file.  It  then  writes  a  line  containing  a  caret  (’*’)  under  the  character  at  which  scanning  failed 
and  finally,  a  line  containing  an  error  message.  It  then  goes  on  to  process  the  remaining  lines 
of  the  file.  If  errors  have  been  encountered  then  at  the  end  of  the  output  file  spcpp  writes 
messages  to  the  effect  that  errors  have  been  encountered  and  exits  with  status  1.  Tlie  error 


UW/NW  VLSI  Release  2 


2 


lQ/1/83 


SPCPP(l.VLSI) 


VLSI  CAD  Tools  Manual 


SPCPP(l.VLSI) 


messages  written  to  the  output  file  begin  with  dollar  signs.  In  addition,  some  number  of  mes¬ 
sages  are  directed  towards  the  standard  error  output. 

BUGS 

The  target  strings  are  not  checked  to  see  whether  they  are  valid  numerals  or  not.  This  can  be 
regarded  as  either  a  bug  or  a  feature. 

The  target  string  must  fit  into  the  space  from  the  left  to  right  token  delimiter  inclusive.  This 
is  normally  not  a  problem  since  most  node  numbers  will  be  small  integers  and  the  available 
space  will  be  at  least  three  characters.  This  was  done  so  that  the  input  lines  and  the 
translated  outputs  would  line  up  vertically. 
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NAME 

Spice  -  circuit  simulator 
SYNOPSIS 

Spice  infile  ourfile  [nupfile] 

DESCBIPTION 

Spice  reads  a  circuit  description  from  iifiie.  Output  is  written  to  outfiie.  and  error  messages  to 
standard  error.  An  optional  output  file,  mtpfile,  can  be  used  by  mtp  to  obtain  a  multiple  time 
series  plot  on  a  Printronix. 

Spice  calls  spice2g6,  a  general-purpose  circuit  simulation  program  for  nonlinear  DC,  nonlinear 
transient,  and  linear  AC  analyses.  Circuits  may  contain  resistors,  capacitors,  inducton, 
mutual  inductors,  independent  voltage  and  current  sources,  four  types  of  dependent  sources, 
transmission  lines,  and  the  four  most  common  semiconductor  devices:  diodes,  BJTs,  JFETs, 
and  MOSFETs. 

Spice2g6  has  buUt-in  models  for  the  semiconductor  devices,  and  the  user  need  specify  only  the 
pertinent  model  parameter  values.  The  model  for  the  BJT  is  based  on  the  integral  charge 
model  of  Gummel  and  Poon;  however,  if  the  Gummel-Poon  parameters  are  not  specified,  the 
model  reduces  to  the  simpler  Ebers-Moll  model.  In  either  case,  charge  storage  effects,  ohmic 
resistances,  and  a  current-dependent  output  conductance  may  be  included.  The  diode  model 
can  be  used  for  either  junction  diodes  or  Schottky  barrier  diodes.  The  JFET  model  is  based 
on  the  FET  model  of  Shichman  and  Hodges.  Three  MOSFET  models  are  implemented;  MOSl 
is  described  by  a  square-law  I-V  characteristic,  MOS2  is  an  analytical  model  while  MOS3  is  a 
semi-empirical  model.  Both  MOS2  and  MOS3  include  second-order  effects  such  as  channel 
length  modulation,  subthreshold  conduction,  scattering  limited  velocity  saturation,  small  sixe 
effects  and  charge-controlled  capacitances. 

To  build  a  Spice  input  file  for  your  circuit  from  mextra  output  run  sim2spiee  or  pspice. 

SEE  ALSO 

mextra(l.vlsi) 

mtp(l.vlsi),  sim2spice(l.vlsi),  pspice(l.vlsi),  spcpp(l.vlsi) 

SPICE  User's  Guide,  VLSI  Design  Tools  Reference  Manual,  UW/NW  VLSI  Consortium, 
University  of  Washington,  (SPICE  Version  2C6  User’s  Guide,  A.  Vladimirescu  et  at.,  IS 
October  1980). 

Program  Reference  for  Spice2,  E.  Cohen,  ERL  Memo.  ERL-M592,  Electronics  Research 
Laboratory,  University  of  California,  Berkeley,  June  1976. 

SPICE2:  A  Computer  Program  to  Simulate  Semiconductor  Circuits,  L.W.  Nagel,  ERL  Memo. 
ERL-MS20,  Electronics  Research  Laboratory,  University  of  California,  Berkeley,  May  197S. 

The  Simulation  of  AiOS  Integrated  Circuit  Using  SPICE2  A.  Vladimirescu  and  Sally  Liu, 
UCB/ERL  MBOn,  University  of  California,  Berkeley,  February  1980. 

AUTHOR 

(UCB) 

BUGS 

MOSFET  Model,  Level=>2  does  not  work,  due  to  a  charge  conservation  problem  (it  grows). 
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NAME 

tplB  -  technology  independent  PLA  generator 
SYNOPSIS 

tpia  (*acv]  [••  styl€\  [-o  output  JUe\  input  Jite 
DESCEIPTION 

Tpia  is  a  PLA  generator  that  generates  PLAs  in  several  different  styles  and  technologies.  The 
input  format  is  compatible  with  aqntott.  see  PLA(S)  for  details.  Tpia  does  not  handle  ^lit  and 
folded  PLAs. 

Tpia  is  a  program  written  with  the  Tpack  system. 

STYLES  OF  PLAs  AVAILABLE 

The  following  styles  of  PLAs  are  currently  supported: 

Bcis  Buried  contacts,  nMOS,  cis  version  (inputs  and  outputs  on  same  side  of  the 
PLA).  Clocked  inputs  and  outputs  are  supported.  Berkeley  design  rules. 

Btrans  Buried  contacts,  nMOS,  trans  version  (inputs  and  outputs  on  opposite  sides  of 
the  PLA).  Clocked  inputs  and  outputs  are  supported.  Berkeley  design  rules. 

Mels  Mead  &  Conway  design  rules.  Butting  contacts,  nMOS,  cis  version  (inputs  and 
outputs  on  same  side  of  the  PLA).  Clacked  inputs  and  outputs  are  supported. 

Mtrans  Mead  &  Conway  design  rules.  Butting  contacts,  nMOS,  trans  version  (inputs 
snd  outputs  on  opposite  sides  of  the  PLA).  Clocked  inputs  and  outputs  are 
supported. 

Tela  Just  like  Bcis  except  that  it  has  protection  frames  and  terminals  added  (a  spe¬ 
cial  mod  for  EECS  at  Berkeley). 

Ttraos  Just  like  Btrans  except  that  it  has  protection  frames  and  terminals  added. 

Isocnas 

Complies  with  GTE  S  micron,  isoemos  process  (lambda  =  2S  microns).  Inputs 
and  outputs  on  same  side  of  PLA.  Fabricated  and  tested. 

CS3els  Complies  with  MOSIS  3  micron  bulk  CMOS  process  (lambda  »  1.0  microns). 
Berkeley  design,  simulated  but  not  fabricated.  Inputs  and  outputs  on  same  side 
of  the  PLA. 

CSSCran 

Same  as  CSScIs  except  inputs  and  outputs  on  opposite  sides  of  the  PLA. 

It  is  easy  to  create  a  template  for  a  new  style  of  PLA,  and  tpla(CADS)  has  informa¬ 
tion  on  how  to  do  it.  If  you  develop  a  particularly  nice  template  and  would  like  to 
share  it,  send  it  to  *mayo@berkeiey'  or  'ucbvBzhnayo'. 

Tpia  handles  CEF  symbol  naming  directives  and  input  St.  output  labels  as  described  in 
pla(CADS). 

OPTIONS 

•1  Clock  the  inputs  to  the  PLA,  if  this  feature  is  supported  for  this  style. 

•O  Clock  the  outputs  to  the  PLA,  if  this  feature  is  supported  for  this  style. 

-G  fuim  Insert  an  extra  ground  line  every  num  rows  in  the  AND  plane  and  every  num  columns 
in  the  OR  plane. 

-S  Hum  Stretch  power  and  ground  lines  by  num  lambda. 

•V  Be  verbose,  and  show  (in  the  Caesar  output)  how  the  PLA  was  constructed  from  its 
basic  components. 
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•V  Be  verbose,  and  print  out  infonnatioo  about  what  tpla  is  doing.  This  option  implies 

-V. 

•a  produce  Caesar  format  (this  is  the  default) 

•c  produce  CIF  format 

•0  The  next  argument  is  taken  to  be  the  base  name  of  the  output  file.  The  default  is  the 
input  file  name  with  any  extensions  removed.  If  the  input  comes  from  the  standard 
input  and  the  -a  option  is  not  specified  then  the  output  will  go  to  the  standard  output. 

•a  The  next  argument  specifies  the  style  of  PLA  to  generate.  (This  causes  tpla  to  use  the 
file  'ead/Ub/tpla/p-jfy/«.tp  as  its  template). 

-I  num  Set  lambda  to  num  centimicrons.  (200  is  the  default) 

-t  The  next  argument  ^ecifies  the  template  to  use,  this  normally  defaults  to  the  standard 
library.  A  .tp  suffix  is  added  if  no  suffix  wu  specified.  This  option  is  useful  for  gen¬ 
erating  styles  of  PLAs  that  are  not  included  in  the  standard  library. 

i/y>ia _fUe 

The  file  containing  the  truth_tabie.  If  this  filename  is  omitted  then  the  input  is  taken 
from  the  standard  input  (such  as  a  pipe). 

other  options 

This  program  inherits  several  more  options  from  Tpack(CAD). 

FILES 

'cad/bin/tpla  ~  executable 

*cad/src/tpla/«  -  source 

'cad/lib/tpla/p«.<p  --  standard  templates  for  PLAs 

SEE  ALSO 

eqotott(CAD),  presto(CAD),  plasort(CAD),  pIa(CAD5),  tpIa(CADS),  tpack(CAD), 
mkpla(CAD) 

AUTHOR 

Robert  N.  Mayo 

BUGS 

The  defaults  for  the  -G  and  -S  options  have  no  way  of  knowing  what  the  grounding  require¬ 
ments  are  for  the  style  of  PLA  actually  being  generated. 

If  the  template  CS3cis  or  CS3tran  is  used  with  an  odd  number  of  minterms  and  the  -G  option 
is  used,  there  will  be  design  rule  violations;  extra  pieces  of  P-t-  implant  along  the  bottom  of 
the  OR  plane,  which  will  have  to  be  manually  removed. 

The  templates  Tcis  and  Ttrans  imply  a  technology  (fnmos)  not  supplied  on  the  Berkeley  tape. 
These  templates  will  not  be  useful  unless  the  associated  technology  files  are  obtained. 

This  program  inherits  any  bugs  that  may  exist  in  tpack(CAD). 
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NAME 

vie  -  view  u  integrated  circuit  layout  (versioa  2.1). 

SYNOPSIS 

vie  [optioiu]  symbol  name 
DESCEIPTION 

Vic  is  an  interactive  graphics  display  program  for  integrated  circuits  that  is  technology 
independent  and  has  a  built-in  hardcopy  feature.  It  understands  layouts  in  Caesar  data  base 
format.  It  currently  displays  only  on  the  GP19  and  Tek410S  graphics  terminals,  but  it  can  pro¬ 
duce  a  hardcopy  on  a  number  of  devices. 

The  options  are  as  follows: 

-t  technology 

Supported  values  of  technology  are  nmos  and  cmes-pw.  Default  is  emoa-pw. 

-h  plotter 

Supported  values  for  plotter  are  HP7221CT,  HP7221AB,  HPTSSO,  HP75I0B  and 
Tek4M2_31.  Default  U  HP7i80. 

-t  graphics 

Supported  values  for  graphics  are  GP19  and  Tek4105.  Default  is  GP19. 

-f  format 

The  only  Choice  for  format  of  symbol  to  be  read  is  ca  (Caesar  files). 

COMMANDS 

For  all  the  commands,  only  the  portion  enclosed  in  parentheses  need  be  typed  and  a  list  of  the 
possible  parameters  for  each  command  (if  any)  and  current  values  are  i^own  after  the  com¬ 
mand  in  the  menu. 

(Iay)crs  <  llst> 

sets  the  layers  to  be  plotted.  The  list  consists  of  layer  names  seperated  by  ^aces,  or 
the  entire  list  may  be  preceded  by  a  *+*.  In  the  latter  case,  the  given  layers  are  added 
to  the  plot  ALREADY  on  the  screen  (it  should  be  pointed  out  that  a  space  must  fol¬ 
low  immediately  after  the  followed  by  the  additional  layers).  A  null  list  sets  all 
layers  to  be  plotted.  Abbreviations  are  allowed.  The  first  layer  with  the  abbreviation 
as  its  leading  part  will  be  selected.  (Thus,  metal  can  be  abbreviated  m,  me,  met  or 
meta,  whereas  metal2  will  require  the  entire  name.  Warning:  layer  names  such  as 
metal2  and  cut2  must,  therefore,  follow  metal  and  cut,  respectively  in  the  technology 
files.)  Default  is  all  layers. 

(n)csUiig  levels  <  oamber> 

set  the  number  of  levels  in  the  symbol’s  hierarchy  to  be  plotted.  Any  symbol  at  a  level 
greater  than  this  will  show  up  only  as  a  bounding  box  with  its  symbol  name  in  the 
lower  left  comer.  The  current  symbol  is  at  level  1,  its  children  are  at  level  2,  and  so 
on.  Default  is  1. 

(w)lBdow 

window  in  on  the  plot.  Use  the  graphics  cursor  to  move  to  the  desired  lower  left 
comer  of  the  window  and  hit  the  ^ace  bar.  Then  move  to  the  upper  right  comer  and 
do  the  same. 

(hanl)copy 

produce  a  hardcopy  of  exactly  what  is  shown  on  the  terminal  screen  on  a  pen  plotter. 
A  grid  may  be  placed  over  the  hardcopy  by  specifying  anything  greater  than  zero 
when  the  program  prompts  for  grid  size.  For  this  option  to  work,  the  user’s  terminal 
must  communicate  with  the  host  through  the  plotter,  in  order  that  the  plotter  may 
intercept  the  plotting  commands.  For  the  Tek410S,  the  grid  must  be  displayed  prior  to 
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hard  copying. 

(Iab)cb  <  valae> 

turn  node  labels  on/off.  Default  is  on. 

(p) lot  plot  on  the  graphics  terminal  with  the  current  options  in  effect. 

(v)lcw  view  on  the  graphics  terminal  the  current  symbol  fully  instantiated  with  all  layers  and 
node  labels. 

(g)raphlcs 

return  to  the  graphics  screen  (Tek41Q5  only). 

(tri)d  put  a  grid  on  the  graphics  screen  (Tek410S  only). 

(he)lp  show  the  menu. 

(c)iplain 

explain  each  command.. 

(q) nlt  <}oit  from  the  program. 

(slymbol  <  nama> 

select  the  symbol  to  be  plotted.  The  only  symbols  that  can  be  specified  are  those  in 
the  sub-hierarchy  of  the  top  level  symbol  on  the  command  line.  Note  that  this  is  not  a 
facility  to  reinitialize  the  vie  with  a  new  symbol.  Executing  this  conunand  with  no 
name  causes  the  list  of  symbols  to  be  displayed.  Default  is  the  highest  level  symbol. 

<eoatrol>  C 

causes  current  operation  in  progress  to  cease.  On  the  Tek4105,  to  terminate  a  hard¬ 
copy  in  progress,  depress  the  <shift>  cancel  key  on  the  keyboard  and  type  a  carriage 
return. 

DIAGNOSTICS 

If  an  error  occurs,  a  message  is  written  to  standard  error  and  the  program  exits  with  a  non¬ 
zero  status. 

riLMS 

technologyXec2 
technology  jcvcvp 
symbol. mx 
symbol.cn 

SEE  ALSO 

caesar(CADl),  tec(S.vIsi) 

AUTHOB8 

Pat  Bates 
Larry  McMurchie 
Wayne  E.  Winder 
Bruce  A.  Yanagida 
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1  Introduction 

This  document  provides  a  general  description  of  Coordinate  Free  LAP  (CFL).  This  first  section  summarizes 
the  system’s  capabilities.  The  next  section,  Entities,  describes  the  objects  which  are  manipulated  by  CFL. 
The  third  section.  Operators,  describes  the  CFL  operators  by  functional  group.  Chapter  4  describes  the 
routers.  Chapters  5  and  6  describe  CFL  macros  and  the  wire  facility.  Chapter  7  describes  the  access  to 
the  CFL  library  and  other  procedural  issues  related  to  development  of  CFL  applications.  The  Appendix 
provides  an  alphabetic  listing  of  all  of  the  CFL  routines,  with  their  calling  sequences,  grouped  into  categories 
which  correspond  to  the  chapters  of  this  manual. 

1.1  Overview 

CFL  is  a  library  of  subroutines  written  in  C  intended  to  facilitate  the  construction  of  VLSI  circuit  layouts. 
The  system  u  organized  algebraically  in  that  there  is  a  data  type  called  SYMBOL,  a  set  of  primitive 
operands  of  this  type,  and  a  set  of  operators  which  generate  new  SYMBOLS  by  forming  combinations  of 
existing  SYMBOLS. 

The  system  has  a  very  small  set  of  geometric  primitives  which  may  combined  to  make  objects.  There 
u  a  somewhat  larger  set  of  non-primitive  objects  called  macros,  which  may  be  used  to  generate  frequently 
used  structures  such  as  contacts.  Routing  facilities  are  provided  which  generate  a  variety  of  planar  and 
non-planar  wiring  patterns  used  to  connect  functional  blocks.  Additionally,  there  is  a  coordinate  dependent 
facility  called  wire  for  generating  arbitrary  configurations  of  material. 

The  system  has  been  designed  to  operate  in  conjunction  with  Caesar  in  that  it  u  capable  of  both  accessing 
symbols  generated  using  Caesar  and  writing  symbob  which  may  be  accessed  by  Caesar.  Although  CFL  has 
sufficient  functionality  to  allow  definitions  to  be  developed  for  all  artwork  including  the  lower  level  ceUs  in 
a  design,  it  b  intended  to  be  used  more  in  the  mode  of  chip  assembly.  Hence  the  typical  application  would 
involve  using  Ceasar  to  generate  lower  level  celb  or  tiles  and  then  using  CFL  facilities  to  assemble  these  leaf 
celb  into  higher  level  modules. 

To  insure  that  a  wide  variety  of  assembly  situations  can  be  accomodated,  CFL  includes  approximately 
70  variants  of  operators  for  juxtaposing,  transforming,  and  replicating  heirarchies  of  symbob.  The  syntax 
of  these  operators  b  quite  compact  since  generated  symbob  are  simply  stored  in  program  variables  of  type 
SYMBOL  *. 

All  of  the  calculations  which  support  the  operators  of  CFL  are  performed  from  descriptions  of  the  borders 
of  the  symbob.  The  information  in  the  border  descriptions  includes  the  bounding  box  and  Ibts  of  coordinates 
of  the  points  where  each  kind  of  material  in  the  symbol  makes  contact  with  the  bounding  box.  If  a  border 
description  is  available  for  a  particular  symbol,  CFL  will  not  require  access  to  any  of  the  rest  of  the  geometry 
of  symbol. 

The  system  will  automatically  generate  border  descriptions  from  the  geometry  whenever  the  need  arises 
but  it  will  also  automatically  save  them  on  dbk  when  library  symbob  are  written  out.  In  this  way,  modules 
which  have  a  large  number  of  rectangles  may  be  accessed  from  the  library  without  the  need  of  reading  all  of 
the  files  associated  with  their  sub-modules.  Thu  capability  allows  CFL  to  assemble  large  blocks  of  circuitry 
extermely  quickly. 

CFL  provides  automatic  heirareby  compression  when  symbob  are  written  to  disk  so  that  only  those 
symbob  which  represent  meaningful  functional  groups  need  be  saved. 
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2  Entities 

The  operations  provided  by  CFL  are  defined  with  respect  to  a  number  of  basic  entities.  These  entities 
include  primitive  geometric  objects  and  compound  objects,  called  symbols;  the  boundaries  of  these  symbob, 
called  borders;  and  individual  symbolic  points  along  these  boundaries. 

2.1  Primitives 

CFL  has  the  following  two  primitive  symbob  • 


boxdayar.dx.dy)  -  box 

labol (nano, dx.dy, poo)  -  roetaafilar  labal 

These  are  the  same  two  primitives  used  by  Caesar.  All  coordinates  are  dimensionless,  box  creates  a  box 
on  the  specified  layer  with  dimensions  dx  and  dy.  label  creates  a  Caesar  label.  The  label  has  associated 
with  it  a  rectangle  with  dimensions  dx  and  dy  and  a  name.  Thb  rectangle  and  name  form  the  graphic  for 
the  label  dbplayed  by  Caesar,  poo  b  used  to  specify  the  position  of  the  name  of  the  label  relative  to  its 
center,  label  does  not  place  any  material  on  a  mask  layer  and,  from  the  point  of  view  of  CFL  operators, 
labeb  have  no  extent.  That  b,  the  bounding  box  of  a  label  b  always  [(0,0),(0,0|  independent  of  the  size  of 
its  associated  graphic  rectangle. 

2.2  Symbols 

A  CFL  symbol  b  either  a  primitive  object  or  an  object  formed  by  combining  primitive  objects  and  other 
symbob  using  the  CFL  operators.  Each  symbol  b  a  collection  of  geometry  (boxes),  calb  to  other  symbob 
(calb)  and  labeb.  CFL  represents  symbob  internally  as  data  structures  having  Ibts  of  boxes,  calb,  and 
labeb  and  all  references  to  symbob  within  a  CFL  application  program  are  made  through  pointers  to  these 
structures.  The  pointers  are  declared  with  the  declarator  SYMBOL*. 

For  example. 


SYMBOL  *boxl,*box2,*croasl,*palrl; 

bexl  -  box("a«tal*,  3,10);  /•  vertical  bar  */ 

bo:^  ■  bax(*natal*.10,  3);  /*  horlxoatal  bar  */ 

creaat  •  ce(boxl,bo}^) ;  /•  natal  croaa  */ 

pairl  ■  ex(eroatl,croMl) ;  /•  two  adjacoat  croaaoa  •/ 


In  thb  example,  ee  b  the  center  to  center  alignment  operator  of  CFL.  It  creates  a  new  object  by 
juxtaposing  the  center  of  the  vertical  bar  and  the  center  of  the  horizontal  bar.  The  operator  cx  constructs 
a  horizontal  pair  of  crosses,  aligned  by  their  horizontal  center  lines,  with  the  right  edge  of  the  first  cross 
touching  the  left  edge  of  the  second  cross.  (All  CFL  operators  are  declared  SYMBOL  *  by  the  include  file 
‘cfi.h’  which  must  be  included  in  CFL  application  programs.) 


2.3  Symbolic  Points 


For  each  symbol,  CFL  maintains  a  Ibt  of  coordinates  which  mark  the  centers  of  all  intersections  of  mask 
layers  and  the  bounding  box.  These  sets  of  coordinates,  called  crossings,  are  maintained  seperately  for  each 
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mask  layer  and  for  each  of  the  four  sides  of  the  bounding  box.  Each  crossing  may  be  referred  to  by  speci^  ing 
its  symbol,  side  of  the  bounding  box,  layer  and  ordinal  along  the  side. 

For  example,  the  symbol,  pairl,  generated  above  looks  some  thing  like  this  • 


The  crossings  are  given  by  the  following  four-tuples  - 


(p«lrl. 

"top". 

"natal" , 

1) 

(pairl. 

"tap". 

"natal". 

2) 

(pairl. 

"bot". 

"natal". 

1) 

(pairl. 

•bot". 

•natal*. 

2) 

(pairl. 

"loft". 

"natal". 

1) 

(pairl , 

"right". 

"natal". 

1) 

The  string  literak  ‘top’,  ‘bot’,  ‘left’,  and  ‘right’  are  used  by  CFL  to  indicate  the  sides  of  bounding  boxes. 
Layemames  like  ‘metal’  are,  of  course,  technology  dependent.  For  each  technology,  CFL  uses  the  long  format 
Caesar  layer  names.  All  crossing  ordinals  start  at  1  and  increase  along  the  coordinate  corresponding  to  the 
bounding  box  edge  in  question.  Top  and  bottom  ordinals  increase  from  left  to  right.  Left  and  right  ordinals 
increase  bottom  to  top. 

Several  of  the  routing  operators  in  CFL  have  symbolic  points  as  arguments.  These  arguments  are  declared 
to  be  of  type  PT  *  and  are  generated  by  the  symbolic  point  descriptor  constructor,  pt.  For  example,  to 
construct  symbolic  points  which  refer  to  the  leftmost  and  rightmost  metal  crossings  in  pairl  above,  the 
following  program  statments  are  used  - 


PT  •pl,*p2; 

pi  ■  pt (pairl,  "laft*.  "natal*,  1): 
p2  ■  pt (pairl,  "right",  "natal",  1); 
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2.4  Borden 

CFL  borders  are  used  as  ar^ments  to  some  of  the  routers.  A  border  is  similar  to  a  symbolic  point  in  that 
it  is  referenced  through  a  descriptor  declared  BORDER  *  and  constructed  using  a  constructor,  in  this  case, 
bd.  In  the  simplest  case,  a  border  contains  ail  the  crossings  associated  with  a  given  symbol,  side  and  layer. 
The  same  convention  described  above  is  used  for  numbering  the  crossings.  Hence, 


BOBDEX  *bl,«ba; 

bl  >  bd(pairl,  "top",  "autal"): 
b3  >  bd(pairl.  “but*,  •natal") ; 

constructs  two  borders;  bl,  containing  all  the  metal  crossings  on  the  top  of  pairl,  and  b2,  containing  all  the 
metal  crossings  on  the  bottom  of  pairl. 

In  addition  to  the  basic  border  constructor  which,  by  default,  includes  all  crossings  in  its  resulting  border 
description,  CFL  provides  operators  bdln  and  bdex  for  including  and  excluding  specfic  crossing  ordinals 
from  border  descriptions.  In  general  then,  the  border  description  facilities  are  capable  of  directing  the 
routers  to  consider  any  subset  of  crossings  along  the  side  of  a  particular  symbol.  For  example,  the  following 
statements  consturct  a  description  of  the  top  of  pairl  which  includes  only  the  second  crossing: 


bl  ■  bdCpairl,  •top",  •■otnl"); 
bl  •  bd«x(bl,l); 

In  the  special  instance  that  the  ordinal  argument  is  zero,  bdln  will  include  all  crossings  in  its  resulting 
border  and  bdex  will  exclude  all  corssings  from  its  resulting  border. 

Currently  CFL  borders  are  limitted  to  a  maximum  of  512  crossings.  To  obtain  the  number  of  crossings 
currently  in  a  border  b: 

a  >  nbe(b); 
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3  Operators 

CLF  haa  six  classes  of  operators  - 

iligaaaat  eparatora 
Linear  transforaatiene 
Array  eeaatrnetera 
Tlllac  eparatora 
Library  aceaaa  eparatora 
Mlaeallaaoena  eparatora 

3.1  Alignment  operators 

The  augment  operators  combine  a  pair  of  symbols  by  placing  them  in  one  of  several  relationships  with 
respect  to  each  other.  The  coordinate  free  nature  of  CFL  stems  largely  from  the  fact  that  the  alignment 
operators  typically  specify  the  position  of  one  symbol  relative  to  another  rather  than  the  position  of  either 
of  them  relative  to  a  more  global  set  of  coordinates.  CFL  has  six  categories  of  alignment  implemented  as 
the  following  thirteen  alignment  operators  - 


1.  Cantar  to  cantar  ee 

а.  Cantar  lina  to  cantor  lino  ex.ey 

3.  Edga  to  adga  ll.rr.tt.bb 

4.  Bordar  to  bordor  bx.by 

б.  Point  to  point  or  cantor  pax, pay. cp 

6.  Origin  to  origin  oo 


Each  of  these  operators  has  two  arguments  ol  and  oB  which  are  symbol  pointers,  declared  SYMBOL  *. 
The  operators  form  a  new  symbol  containing  ol  and  s3  positioned  acccording  to  the  indicated  alignment 
criterion.  The  position  of  a3  relative  to  al  in  thu  new  symbol  b  called  the  (0,0)  position.  All  of  the  alignment 
operators  have  three  additional  variations  which  allow  the  specification  of  offsets  from  thb  (0,0)  position  in 
the  X,  y,  or  both  directions.  The  variations  are  formed  by  suffixing  the  operator  name  with  dx,  dy,  or  dxy. 
For  example,  the  cx  operator  has  the  following  four  forms: 

cx(sl,s3)  -  pair  la  x,  cantar  allgnad 

cxdx(al,aa,dx)  -  pair  la  x.  cantar  allgnad,  x  offaat 

cxdy(al,aa,dy)  -  pair  la  x,  cantar  allgnad,  y  offaat 

cxdxy(al,oa,dx,dy)  -  pair  la  x.  cantar  allgnad,  xy  offaat 


3.2  Center  to  center  alignment 

The  ee  operator  forms  a  symbol  which  consbts  of  al  overlayed  with  a3.  The  symbob  are  aligned  so  that  the 
centers  of  their  respective  bounding  boxes  are  coincident.  Thb  position  b  the  (0,0)  position  with  respect  to 
any  offsets  supplied  by  the  dx,  dy,  and  dxy  variants. 

eeCil.sfi)  -  align  cantor  to  cantar 

ccdx(al,oa,dx)  -  align  cantar  to  cantar,  x  offaat 

ccdy(al.a2,dy)  -  align  cantar  to  cantar,  y  offaat 

cedxyCal.aa.dx.dy)  -  align  cantar  to  cantor  xy  offaat 
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3.S  Center  line  alignment 

The  ex  operator  forms  the  horizontal  pair  of  symbols  (sl,s3).  The  ri^ht  side  of  the  bounding  box  of  si  is 
adjacent  to  the  left  side  of  the  bounding  box  of  aS  and  the  cells  are  aligned  by  their  horizontal  center  lines. 
Thu  position  is  taken  to  be  the  (0,0)  position  with  respect  to  the  offsets  which  may  be  supplied  using  the 
dx,  dy,  and  dxy  variants. 

The  cy  operator  forms  the  vertical  pair  of  sumbols  (sl,sS).  The  top  side  of  the  bounding  box  of  si  is 
adjacent  to  the  bottom  side  of  the  bounding  box  of  s3  and  the  cells  are  aligned  by  their  vertical  center  lines. 
This  position  is  taken  to  be  the  (0,0)  position  with  respect  to  the  offsets  which  may  be  supplied  using  the 
dx,  dy,  and  dxy  variants. 


cx(al,aa)  -  pair  in  x.  esntsr  allgnsd 

cxdx(Bl.s2,dx)  -  pair  la  x,  eantar  allgasd,  x  offset 

cxdy(sl,sa,dy)  -  pair  la  x,  eostar  allgasd,  y  effsst 

cxdxy(al,Ba,dx,dy)  -  pair  la  x.  esaksr  allgasd,  xy  offset 

ey(al,aa)  -  pair  la  y,  eaator  allgasd 

cydx(sl,aa,dx)  -  pair  la  y,  castor  allgasd,  x  offset 

eydy(sl,aa,dy)  -  pair  la  y,  cantor  allgasd,  y  effsst 

eydxy(sl,aa,dx,dy)  -  pair  la  y,  coster  allgasd,  xy  offset 


3.4  Common  edge  alignment 

The  operators  in  this  group  align  a  pair  of  symbob  (sl,s3)  so  that  a  specified  edge  of  their  bounding  boxes 
lies  on  the  same  line.  In  the  (0,0)  position,  the  bounding  boxes  of  the  symbob  are  adjacent.  There  are  four 
operators,  each  with  offset  variants.  s3  b  placed  to  the  right  of  si  in  the  case  of  the  bb  and  tt  operators. 
s3  b  placed  above  ol  in  the  case  of  the  11  and  rr  operators. 


bb(sl,s3)  -  allga  bettea  to  bettoa 

bbdx(sl,a2,dx}  -  allga  bettoa  to  bottoa,  x  offset 

bbdy(ai,a3,dy)  -  allga  bottoa  to  bettoa,  y  offset 

bbdxy(sl,s2,dx,dy)  -  allga  bottoa  to  bettea  xy  offset 

11(o1,b2)  -  allga  loft  to  loft 

lldx(sl,a2,dx}  -  allga  loft  to  loft,  x  offset 

lldy(sl,s2,dy)  -  allga  loft  to  loft,  y  offset 

lldxy(sl,o2,dx,dy)  -  allga  loft  to  loft,  xy  offset 

rr(sl,s2)  -  allga  right  to  right 

rrdx(ol,s2,dx}  -  allga  right  to  right,  x  offset 

rrdy(sl,s2,dy)  -  align  right  to  right,  y  offset 

rrdxy(Bl,s2,dx,dy)  -  allga  right  to  right,  xy  offset 

tt(Bl,s2)  -  allga  top  to  top 

ttdx(sl,s2,dx)  -  align  top  to  top,  x  offset 

ttdy(sl,s2,dy)  -  allga  top  to  top,  y  offset 

ttdxy(ol,s2,dx,dy}  -  align  top  to  top,  xy  offset 
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3.6  Border  alignment 


The  bx  operator  forms  the  horizontal  pair  of  symbob  (al,a2).  The  right  side  of  the  bounding  box  of  il 
u  adjacent  to  the  left  side  of  the  bounding  box  of  al  and  the  symbob  are  aligned  so  that  corresponding 
patterns  of  material  at  the  common  border  match  up.  Thu  position  b  taken  to  be  the  (0,0)  position  with 
respect  to  the  offsets  which  may  be  supplied  using  the  dx,  dy,  and  dxy  variants. 

The  by  operator  forms  the  vertical  pair  of  symbob  (sl,s3).  The  top  side  of  the  bounding  box  of  al  is 
adjacent  to  the  bottom  side  of  the  bounding  box  of  al  and  the  symbob  are  aligned  so  that  corresponding 
patterns  of  material  at  the  common  border  match  up.  Thu  position  u  taken  to  be  the  (0,0)  position  with 
respect  to  the  offsets  which  may  be  supplied  using  the  dx,  dy,  and  dxy  variants. 

The  algorithm  that  performs  the  alignment  for  bx  and  by  will  use  center  line  alignment  if  it  can  not 
identify  the  same  pattern  of  material  common  to  the  adjacent  borders  of  the  symbob  and  usue  a  warning 
message. 


bx(tl.aa) 
bxdx(al,a2,dx) 
bxdy(al.a2.dy) 
bxdxy(al,a2,dx,dy)  - 

by(al,a2) 
bydx(al,a2,dx) 
bydy(al,a2,dy) 
bydxy(al,a2,dx.dy)  - 


pair  In  x,  bordara 
pair  la  x,  bordara 
pair  la  x.  bordara 
pair  in  x,  bordara 

pair  la  y,  bordara 
pair  in  y,  bordara 
pair  in  y,  bordara 
pair  in  y.  bordara 


alignod 

aligaad.  x  offaat 
alignod.  7  offaat 
aligaad,  xy  offaat 

aligaad 

aligaad,  x  offaat 
aligaad.  y  offaat 
aligaad,  xy  offaat 


3.0  Point  alignment 

The  point  to  point  alignment  operators  are  similar  to  the  border  alignment  operators  except  that  the  symbols 
are  aligned  so  that  specific  points  on  the  respective  borders  are  adjacent.  Thu  allows  cases  to  be  handled 
that  do  not  meet  all  the  conditions  necessary  for  running  the  automatic  alignment  algorithm  of  the  border 
alignment  operators. 

The  pax  operator  forms  the  horizontal  pair  of  symbob  (al.sfi).  In  the  (0.0)  position,  the  right  side  of 
the  bounding  box  of  al  is  adjacent  to  the  left  side  of  the  bounding  box  of  a2  and  the  symbols  are  aligned 
so  that  the  symbolic  point  nl  on  the  right  side  of  al  u  adjacent  to  the  symbolic  point  n2  on  the  left  side  nI 
s2.  Both  points  are  taken  to  be  on  the  same  layer. 

The  pay  operator  forms  the  vertical  pair  of  symbob  (sl,a2).  In  the  f0,0)  position,  the  top  side  of  the 
bounding  box  of  al  u  adjacent  to  the  bottom  side  of  the  bounding  box  of  a2  and  the  symbob  are  aligned  so 
that  the  symbolic  point  nl  on  the  top  of  al  u  adjacent  to  the  symbolic  point  n2  on  the  bottom  of  a2.  Both 
points  are  taken  to  be  on  the  same  layer. 


pax(sl,al,a2,n2,layar) 
paxdxCal , al , s2 , n2 , layar , dx) 
paxdy(al,Bl,a2,B2,layar,dy) 
paxdxy (al , al , a2 , a2 , layar , dx, dy) 

pay (al , B 1 . a2 , b2 . layar) 
paydxCal , Bl , a2 , a2 , layar , dx) 
paydy (al . al , a2 , b2 , layar , dy) 
paydxy (a 1 , al , a2 , a2 , layar , dx. dy) 


-  poiat  align  la  x 

-  point  align  la  x,  x  offaat 

'  poiat  align  ia  x,  y  offaat 

'  poiat  aliga  ia  x,  xy  offaat 

-  poiat  aliga  ia  y 

-  point  aliga  la  y,  x  offaat 

-  poiat  aliga  ia  y,  y  offaat 

-  poiat  align  ia  y,  xy  offaat 
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The  center  to  point  alignment  operator  is  intended  primarily  for  placing  labels  along  the  borders  of 
symbols.  Typically,  the  inputs  and  outputs  of  a  symbol  will  appear  as  a  series  of  crossings  along  the  edges 
of  its  bounding  box  and  it  will  be  desirable  to  label  these  inputs  and  outputs.  Labeb  of  this  type  are  used 
often  for  the  purpose  of  simulating  an  extracted  circuit,  for  example. 

The  center  to  point  alignment  operators  have  a  symbol  and  a  point  argument.  The  result  is  a  pair  of 
symbols  in  which,  in  the  (0,0)  position,  the  center  of  the  symbol  argument  is  concident  with  the  specified 
point.  In  the  case  of  the  other  alignment  operators,  offsets  refer  to  the  positioning  of  the  second  symbol 
relative  to  the  first.  In  the  case  of  ep,  the  offsets  refer  to  the  positioning  of  the  symbol  relative  to  the  point. 


cp(al,pl)  -  emtur  to  point 

cpdx(ol,pl,dx)  -  contor  to  point,  x  of foot 

cpdy(ol,pl,dy)  -  contor  to  point,  y  of foot 

cpdxy(ol,pi,dx,dy)  -  contor  to  point,  xy  of foot 


A  typical  application  of  cp  to  label  a  number  of  inputs  of  a  symbol  tl  would  look  like  the  following: 


tl  -  cp(lnbol(*in.l",0,0.4),pt(tl."laft".*aotnl*,l) 
ti  «  cp(lnbol(-in.a*,0,0.4).pt(ti,noft-.*aotnl-.a) 
tl  ■  ep(lnbol(«la.3".0.0.4).pt<tl.noft-.-notnl«,3) 
tl  ■  cp<lnbol<'la.4".0,0.4).pt(ti,"loft«,»notnl*,4) 


3.7  Origin  to  origin  alignment 

The  oo  operator  forms  a  symbol  which  consbts  of  ol  overlayed  with  ofi.  The  ceils  are  aligned  so  that  the 
origins  of  their  respective  geometry  are  coincident.  This  position  b  the  (0,0)  position  with  respect  to  any 
offsets  supplied  by  the  dx,  dy,  and  dxy  variants.  Unlike  the  other  alignment  operators,  the  operation  of  oo 
b  coordinate  dependent.  It  b  a  special  purpose  operator  intended  to  be  used  primarily  in  conjunction  with 
the  routers  to  locate  generated  wiring  within  its  containing  cell. 


eo(sl.sa)  align  origia  to  origin 

oedx(nl,na,dx)  -  aliga  origia  to  origia,  x  offaot 

oody(ol,a3,dy)  -  aliga  origia  to  origia.  y  offaot 

oodxy(al,a3,dx,dy}  -  aliga  origia  to  origin,  xy  offaot 


3.8  Linear  tranaformatione 

There  are  three  linear  transformations  - 


ax(s)  -  airror  in  x 
ny(o)  -  airror  ia  y 
rot (a, a)  -  rotate 


The  argument  to  rot  b  in  degrees  and  must  be  an  integer  multiple  of  90.  Note  that  mx  and  my  mirror 
in  the  indicated  coordinate  as  opposed  to  around  the  indicated  axb.  That  b,  mx  operates  by  replacing  x 
with  -X  for  all  x  coordinates  in  its  argument. 
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S.O  Array  constmetors 

There  are  three  array  constructors  nx,  ny,  and  nxy,  which  can  be  used  to  generate  horizontal,  vertical, 
or  rectan^lar  arrays  of  a  ipven  symbol.  As  in  the  case  of  the  ali^ment  operators,  offset  variants  of  these 
operators  are  also  defined.  The  interpretation  of  the  offsets  is,  however,  slightly  different,  dx  and  dy,  when 
supplied,  are  taken  to  be  the  spacings  between  the  bounding  boxes  of  successive  array  elements.  The  (0,0) 
position  is  when  the  bounding  boxes  are  adjacent.  The  variants  of  the  array  operators  which  would  produce 
a  non-rectangular  structure  are  not  defined,  for  example,  nxdy. 


ax(a,a) 

ropaat 

ia  X 

axdx(a,n,dx) 

rapaat 

ia  X,  X  offaat 

nxy (a. ax, ay) 

ropaat 

ia  X  aad  y 

axydx(a,ax,ny,dx) 

rapaat 

ia  X  aad  y.  x 

offaat 

nxydy(a,ax.ay,dy) 

rapaat 

ia  X  aad  y.  y 

offaat 

axyd^Ca.nx.ay.dx.dy)  - 

rapaat 

ia  X  aad  y.  xy 

offaat 

ay (a, a) 

rapaat 

ia  y 

aydy(a,a.dy) 

rapaat 

ia  y.  y  offaat 

There  are  three  additional  array  constructors  repx,  repy  and  repxy  which  construct  arrays  of  particular 
spacial  periods.  The  arguments  to  these  routines  are  also  given  as  dx  and  dy  but  they  specify  the  periods 
rather  than  offsets.  These  operators  do  not  have  variants  for  providing  additional  offsets. 


r«px(a,a,dx)  -  repeat  in  x  with  period  dx 

repxy(a,ax,ny,dx,dy)  -  repeat  la  x  and  y.  with  periods  dx  dy 

repy (a, a, dy)  -  repeat  ia  y  with  period  dy 


3.10  Tiling  operators 

Tiling  b  similar  to  an  array  operation  except  that  each  element  of  the  generated  array  can  be  a  different 
symbol.  There  are  three  tiling  operators  vx,  vy,  and  vxy,  which  can  be  used  to  generate  horizontal,  vertical, 
or  rectangular  tilings.  These  opertors  are  similar  to  the  array  operators  except  that  the  first  argument  is  an 
array  of  symbol  pointers  rather  than  a  single  symbol  pointer.  The  tiling  operators,  then,  operate  on  vectors 
of  symbols  so  their  mnemonic  starts  with  v.  There  are  no  offset  variants  for  the  tiling  operators  since  the 
offset  for  each  tile  could  potentially  be  different.  AH  symbob  in  a  row  are  arranged  so  that  theb  bounding 
boxes  are  in  contact  and  aligned  by  their  center  lines. 


vxCa.n) 

vxy (a, ax, ny) 

vyfa.a) 


vector  ia  x 
vector  ia  x  mad  y 
vector  in  y 


vxy  generates  a  plane  of  the  symbob  a  aranged  so  that  theb  bounding  boxes  are  in  contact.  .Kll  symbob 
in  the  same  row  of  the  plane  are  assumed  to  have  the  same  height,  a  b  treated  as  though  it  is  dimensioned 
a[ny][nx]  in  the  calling  program. 
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3.11  Librazy  access 

There  are  two  operations  which  access  library  sybmob  • 


gn(naan) 

- 

gap (naan) 

-  gat 

pnCnann.n) 

-  put 

pap (naan, ■) 

-  pnt 

library  aysbel 

library  aysbol  with  prafix 

symbol  ia  tha  symbol  tabls 

symbol  la  tbs  symbol  tabls  with  prsfix 


gs  will  read  a  library  symbol  in  Caesar  format,  place  the  symbol  in  the  data  base  and  return  a  pointer  to 
it.  If  the  symbol  ia  already  in  the  data  base,  gs  simply  returns  the  pointer,  that  is,  it  will  read  the  symbol 
only  once. 

ps  compresses  the  heirarchy  below  its  argument  and  marks  that  argument  as  a  library  symbol,  cflstop 
will  cause  all  library  symbols  to  be  written  to  the  disk  in  the  Caesar  format. 

The  heirarchy  compressor  removes  from  the  heirarchy  all  cells  which  are  not  marked  as  library  celb,  that 
is,  cells  which  were  not  read  in  with  ga  or  cells  which  have  not  been  marked  as  permanent  by  a  call  to 
pa.  Therefore,  pa  can  be  used  to  not  only  to  save  symbols  but  also  to  control  the  actual  structure  of  the 
heirarchy. 

Currently,  CFL  does  not  support  any  search  path  for  accessing  library  symbob.  All  symbob  are  read 
from  the  sub-directory  ./ca  and  all  output  symbob  are  written  into  ./ca.  Ceasar  or  CFL  symbob  from  global 
cell  libraries  must  be  copied  into  ./ca  before  they  can  be  accessed. 

gap  b  identical  to  gi  except  that  the  CFL  attribute  ‘prefix’  u  prepended  to  the  name,  before  the  symbol 
b  referenced,  pap  b  identical  to  ps  except  that  the  CFL  attribute  ‘prefix’  b  prepended  to  the  name  when 
the  symbol  b  made  permanent.  The  file  on  which  the  symbol  b  written  will  also  have  a  name  which  includes 
the  prefix. 

gap  and  pap  are  intended  for  use  with  generators,  such  as  a  ROM  or  PLA  generator,  in  which  several 
instances  of  the  generated  circuit  may  be  parts  of  a  single  larger  ebeuit.  Since  errors  will  generally  result  if 
the  sub-celb  of  the  various  generated  instances  are  not  kept  dbtinct,  CFL  provides  a  global  symbol  name 
prefix  as  a  way  of  simplifying  the  construction  of  names  which  include  an  instance  indication  as  a  prefix. 

The  following  call  sets  the  prefix  attribute  to  the  value  ROMl  • 

cllintcCprnf  ix« .  "MHl") ; 


Following  thb  call,  the  call 


•1  ■  pnp(*ni",al): 


will  make  •!  a  permanent  symbol  with  the  name  ROMlsl.  ROMlsl.ca  will  be  the  name  of  the  file  containing 
thb  symbol  on  exit. 
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The  remaining  sections  describe  operators  and  routines  do  not  fit  in  any  of  the  above  categ;ories. 

3.12  Symbol  onion 

■n(al,a2)  -  aynbol  nnian 


The  au  operator  performs  symbol  union.  This  operation  merges  tvo  symbols  and  includes  only  one 
instance  of  common  structure.  This  operation  is  useful  in  cases  where  it  is  necessary  to  ali^  more  than  one 
symbol  to  the  same  border  of  a  given  symbol. 

For  example,  suppose  it  is  desired  to  align  the  symbob  n,  b,  and  e  as  follows: 


- - 4 - 4 

I  «  I  I 

- - 4  I 

I  I 

I  e  I 
I  I 

4 - — 4  I 

I  b  I  I 

4......._.4— — -4 


If  n  and  c  are  combined  with  tt,  the  boundmg  box  of  the  result  includes  both  n  and  e,  so  b  can  not  be 
easily  combined  with  thu  result.  The  symetric  situation  occurrs  if  a  pair  b  made  of  b  and  e  using  bb.  The 
difificulty  b  overcome  with  au  in  the  following  manner 


r  «  an(tt(4,e) ,bb(b,e)) 


A  pair  b  made  of  a  and  c  aligned  top  to  top  and  a  pair  b  made  of  b  and  c  aligned  bottom  to  bottom. 

The  result,  r,  b  the  union  of  the  ae  pair  and  the  be  pair  and  includes  only  a  single  instance  of  c. 

It  should  be  stressed  that  the  implementation  of  au  b  less  general  than  its  name  implies.  It  b  intended 
for  application  in  a  commonly  occurring  although  restricted  circumstance  in  which  al  and  a2  consist  only 
of  calls  and  two  of  these  calb,  one  in  al  and  one  in  a2  refer  to  the  same  symbol. 

The  limitiations  of  au  may  be  best  presented  by  outlining  its  algorithm,  au  overlays  al  and  a2  so  that 
common  sub-celb  appear  to  coincide.  Then,  only  one  instance  of  the  common  sub-celb  b  included  in  the 
result  symbol.  The  method  begins  by  searching  al  and  a2  for  a  common  sulvcell  to  use  as  an  alignment  key 
for  super-position.  The  sub-cell  must  be  called  by  both  al  and  a2  and  its  transform  must  be  involve  only 
translation  in  both  cases.  The  search  finds  the  fint  symbol  on  the  call  list  of  al  which  b  also  called  by  a2 
and  which  meets  these  criteria.  (To  qualify  for  the  union  operation  al  and  a2  must  contain  only  calb  -  no 
boxes  and  no  labeb.) 

Next  a  pair  of  transforms  b  generated,  tl  for  the  al  instance  and  t2  for  the  a2  instance,  which  will 
translate  the  alignment  key  to  the  origins  of  its  respective  containers.  Since  the  transforms  in  the  calb  are 
strictly  translations,  the  inverses  can  be  constructed  by  simply  negating  the  dbplacement  elements  of  the 
translation  matrices. 

Finally,  the  union  b  generated  by  copying  the  call  Ibt  of  al  to  the  call  list  of  the  result  applying  tl  to  all 
calb.  During  thb  operation,  a  set  of  the  symbob  called  b  constructed  to  be  used  when  selecting  sub-celb  of 
al  to  include  in  the  union.  Next,  the  call  Ibt  of  a3  b  copied  to  the  call  Ibt  of  the  result  excluding  all  celb 
which  are  already  there  since  they  were  called  by  al.  ti  b  applied  to  any  cell  included  from  a2. 
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Recall  that  tl  translates  the  key  cell  to  the  origin  of  al  and  ako  that  t3  translates  the  key  cell  to  the 
origin  of  aS.  Since  both  of  these  origins  have  the  coordinates  (0,0)  the  alignment  keys  would  exactly  coincide 
in  the  result.  Generalizing  this,  au  assumes  that  any  instance  of  a  cell  called  by  a2  which  is  also  called  by 
al,  were  it  to  be  included  in  the  result,  would  exactly  overlay  some  instance  already  present  in  the  result 
by  virtue  of  a  call  in  al.  As  a  consequence  of  this  assumption,  au  will  not  work  correctly  in  cases  in  which 
there  are  sub-cells  called  by  both  al  and  a3  which  are  not  intended  to  be  coincident  in  the  result. 

3.13  Initialisation  and  termination 

cflatartCtachnology)  -  Initlallsa  cfl 

eflatopO  -  tarainata  cfl 


CFL  can  be  used  with  any  of  the  various  technologies  currently  supported  by  the  design  system.  It 
obtains  its  table  of  layer  names  from  the  .teeS  technology  flies  in  the  FLAP  path.  For  MOSIS  bulk  CMOS 
the  technology  name  is  'cmos-pw'  and  for  NMOS  the  name  is  simply  ‘nmos’. 

cflatart  initializes  the  package.  It  must  be  called  before  invoking  any  other  CFL  functions,  cflatop  causes 
all  permanent  symbols  to  be  written  to  disk  and  should  be  called  just  prior  to  exiting  a  CFL  application. 

3.14  Garbage  collection 


cflcoIlcctO  -  ralaaaa  taaporary  aynbolt 


CFL  does  not  provide  automatic  garbage  collection  -  symbob,  once  created,  are  retained  indeflnitely.  In 
most  instances  thb  will  not  cause  a  problem  since  the  number  of  symbob  generated  by  typical  CFL  appli¬ 
cations  will  not  be  very  large.  For  some  applications  however  looping  constructs  can  generate  a  substantial 
number  of  ‘intermediate’  symbob  which  will  cause  a  memory  overflow.  (In  practice  thb  condition  occurrs 
around  50K  symbob.) 

When  cflcolleet  is  called  by  the  application,  all  space  associated  with  temporary  symbob  is  released. 
Temporary  symbob  are  those  which  were  not  read  in  from  the  library  or  which  have  not  been  saved  with 
a  call  to  ps.  After  calling  cflcolleet  an  application  must  not  attempt  to  reference  the  values  of  any  of 
its  SYMBOL  *  variables  which  were  pointing  to  temporary  symbob  before  the  call.  The  pointers  are  not 
modified  by  cflcolleet  but  the  storage  they  point  to  will  have  been  returned  to  the  system. 

A  typical  application  requiring  cflcolleet  is  one  in  which  a  looping  construct  must  be  used  a  number 
of  times  to  build  up  a  set  of  larger  structures.  After  each  structure  is  generated  it  b  saved  by  calling  pa. 
cflcolleet  b  then  called  to  purge  the  temporaries  from  memory  and  the  next  structure  b  generated  and 
saved. 

3.16  Setting  CFL  Attributes 

cflaetfa.v)  -  aet  CFL  Intagar  attrlhnta 

cflaate(a,v)  -  aat  CFL  charactar  attrlbsta 


These  routines  provide  a  mechanism  for  applications  to  modify  some  of  the  parameters  which  control  the 
operation  of  CFL.  Currently  only  two  of  these  parameters  are  implemented  -  the  integer  attribute  ‘grain’ 
and  the  character  string  attribute  ‘prefix',  'grain'  determines  the  smallest  resolvable  unit  of  dbtance  and 
‘prefix'  sets  the  prefix  to  be  used  with  the  gap  and  pap  operaton.  The  default  grain  b  2  which  means  that 
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all  CFL  dimensions  are  multiplied  by  2  when  they  are  stored  internally  and  written  to  output  files.  A  setting 
of  2  makes  CFL’s  .ca  files  compatible  with  Caesar’s  .ca  files,  (grain  should  always  be  a  multiple  of  2.)  The 
default  prefix  u  empty. 

3.16  Floating  argument  conversion 

All  CFL  routines  which  have  dimensions  or  dbplacements  as  arguments  expect  that  these  arguments  will  be 
given  as  integers.  However,  internally,  CFL  scales  these  integers  so  that  it  is  possible  to  represent  fractional 
values,  say  1.5.  Floating  point  numbers  may  be  used  as  dimension  or  displacement  arguments  to  all  routines 
by  first  applying  the  conversion  routine  - 

f(r)  -  eenvart  floating  argnaont 

For  example, 

■3  »  cxdx(al,a2,f(1.6)): 
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4  Routers 

CFL  does  not  currently  provide  high  level  routing  facilities  such  as  a  general  channel  router  or  switchbox 
router.  Rather,  the  CFL  routers  consist  of  a  set  of  wiring  pattern  generators  each  of  which  is  specialized  to 
a  particular  routing  situation.  These  routers,  which  are  designed  to  be  used  in  combination  with  each  other 
and  the  other  CFL  operators,  support  a  set  of  elementary  routing  operations  from  which  more  sophisticated 
patterns  may  be  constructed. 

There  are  two  types  of  routing  facilities  available  in  CFL,  planar  routers  and  non-planar  routers. 

The  planar  routers  are  • 


pp  -  point  to  point  rontor 
pr  -  gonoral  planar  rontar 
axt  -  border  axtandor 
fill  -  Caaaar  fill  oparatioa 


and  the  non*planar  routers  are  • 


plx  -  horinontal  point  to  lino  rontar 
ply  -  vortical  point  to  lino  rontor 

olb  -  gonoral  albev 

too  -  too 


Generally  speaking  the  planar  routing  facilities  of  CFL  are  technology  independent  whereas  the  non- 
planar  routing  facilities  are  tecnhnology  dependent  since  contacts  must  be  specified. 

Since  CFL  is  coordinate  free,  the  routers  operate  from  border  descriptions  and  from  symbolic  point 
designations.  The  generation  of  symbolic  point  and  border  descriptors  is  described  in  Chapter  2. 

Most  CFL  operators  produce  a  new  symbol  by  combining  existing  symbob.  The  arguments  to  these 
operators  have  no  particular  spacial  relationship  to  each  other  before  the  operation  takes  place.  The  routers, 
on  the  other  hand,  rather  than  combining  symbob,  must  form  connections  between  them.  This  process 
requires  that  the  symbob  to  be  connected  have  a  previously  establbhed  fixed  spatial  relationship. 

Symbob  acquire  a  fixed  spatial  relationship  as  soon  as  they  become  constituents  of  some  higher  level 
symbol.  CFL  refers  to  a  higher  level  symbol,  aO,  which  contains  symbob  ■!  and  afi  as  a  container  of  al  and 
a2.  Within  any  container,  the  relative  positions  of  al  and  a3  are  fixed. 

The  routers,  like  all  other  CFL  operators,  are  SYMBOL  *  valued  functions.  When  a  router  b  invoked  it 
produces  a  pattern  of  wiring  as  its  result.  Thb  pattern  of  wiring  b  not  ‘written’  into  place  directly  by  the 
routing  operation,  rather  it  is  a  seperate  symbol  in  its  own  right.  Therefore  to  connect  two  symbob  using 
the  routers,  two  steps  are  necessary: 


1.  Uaa  ena  of  tha  rontara  to  goaarata  tha  pattara  of 
airing  aaeaaaary  to  fora  tha  daairad  coaaaetioaa. 

2.  Uaa  tha  origin  to  origin  aligaaoat  oparator  to 
loeata  tha  ganaratad  airing  pattara  in  tha  eoatainar 
ao  that  tha  intandad  eonnaetiona  ara  aada. 


In  all  cases,  the  wiring  b  generated  in  the  coordinate  system  of  the  container  and  often  the  two  steps 
above  may  be  combined  using  a  statement  of  the  following  form  - 
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raanlt  *  oo (eoatnlaar , roatar (coatalaar 


The  rationale  for  having  the  generation  and  placement  of  wiring  patterns  performed  as  separate  step* 
rather  than  as  an  atomic  operation  is  that  in  many  cases  routing  problems  require  the  generation  of  complex 
patterns  in  which  wiring  generated  by  one  call  to  a  router  must  itself  be  connected  to  the  wiring  generated 
by  another  call  to  a  router.  Separating  the  generation  allows  the  generated  wiring  to  become  a  separate 
symbol  which  may  be  then  operated  on  using  any  CFL  operator. 

4.1  Planar  routers 


pp(aO,pl,pa,«)  -  point  to  point  rontor 


The  point  to  point  router  generates  a  single  wire  of  width  w  for  connecting  symbolic  point  pi  with 
symbolic  point  p3.  The  layer  of  pi  must  match  the  layer  of  p3.  pi  and  p3  must  be  uniquely  locatable 
within  the  containing  symbol,  aO. 


pr(oO,bl,b2,v)  -  planar  roatar 


The  planar  router  generates  a  planar  wiring  pattern  for  connecting  the  points  specified  by  the  border 
descriptor  bl  to  the  points  specified  by  the  border  descriptor  bfi.  The  borders  must  be  on  the  same  layer 
and  contain  the  same  number  of  points.  Recall  that  the  functions  bdin  and  bdox  may  be  used  to  obtain 
border  descriptors  for  any  subset  of  the  crossings  along  a  border  of  a  symbol.  The  symbols  specified  by  the 
descriptors  bl  and  b3  roust  be  uniquely  locatable  within  the  containing  symbol  oO.  All  wires  will  have  a 
width  of  w. 

To  simplify  the  diagnostic  process,  pr  will  construct  wiring  patterns  whether  or  not  there  is  sufficient 
space  for  the  number  of  wires  requested.  It  will,  however,  issue  a  warning  message  if  any  of  the  generated 
wires  are  closer  than  the  CFL  parameter  minsep.  Abo,  it  will  insure  that  runs  which  are  parallel  to  edges 
of  the  bounding  boxes  of  the  symbob  specified  by  bl  and  b2  are  no  closer  than  the  CFL  parameter  nreoff. 
minsep  and  arcolT  have  the  default  value  of  4  which  b  sufficient  for  most  situations.  They  may  be  modified 
at  any  time  with  the  follow'uig  call  - 


prsetCniassp.arcoff) : 


ext(b.d.w) 


-  border  extender 


ext  generates  a  pattern  of  wiring  for  extending  all  points  in  the  border  b  perpendicularly  for  a  dbtance 
of  d  using  wires  of  width  tw.  In  the  special  instance  that  w  b  tero,  ext  will  use  the  widths  of  the  crossings 
in  the  border.  Typically  these  wiaths  will  not  all  be  the  same. 
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filKs.sldn.d)  -  C«MU  fill 


fill  is  similar  to  ext  except  that  all  layers  crossing  the  indicated  side  are  extended  a  dutance  d.  The 
extensions  have  the  same  widths  as  the  crossings.  As  in  the  case  of  the  border  descriptor  constructors,  the 
side  argument  is  one  of  the  text  strings  ‘top’,  ‘bot*,  ‘left’,  ‘right’. 

For  example,  suppose  it  u  desired  to  generate  a  symbol  aS  which  consbts  of  5  instances  of  a  symbol  si 
placed  a  distance  10  apart  and  connected  by  extending  the  material  on  the  right  side  of  si.  The  following 
code  will  generate  this  configuration. 

sa  «  ex(nx(eo(al,flll(sl.-ri(ht-.10)),4).sl); 

The  fill  operator  generates  a  pattern  which  consists  of  the  layers  of  the  right  side  of  si  extended  for  a 
distance  of  10.  oo  concatenates  this  fill  pattern  to  the  original  symbol  si.  The  resulting  filled  symbol  is 
then  repeated  4  times  by  nx.  Finally,  ex  is  used  to  place  the  right  most  instance  of  si  on  the  row. 

4.2  Non*planar  renters 

plx(s0,pl,p3,*.et)  -  horisontal  point  to  lino  rontsr 
ply(sO,pl,pa,v,ct)  -  vortical  point  to  lino  rontor 

plx  generates  a  single  wire  for  connecting  the  symbolic  point  pi  to  the  vertical  line  running  through  the 
symbolic  point  p3.  The  connection  is  made  horizontally.  The  layer  of  pi  u  taken  to  be  the  layer  of  the  wire, 
pi  and  p3  must  be  uniquely  locatable  in  the  container  symbol,  sO.  The  width  of  the  generated  segment 
is  w.  If  not  NULL,  the  contact,  et,  is  placed  with  its  origin  at  the  intersection  of  the  vertical  line  and  the 
generated  wire. 

ply  generates  a  single  wire  for  connecting  the  symbolic  point  pi  to  the  horizontal  line  running  through 
the  symbolic  point  p3.  The  connection  is  made  vertically.  The  layer  of  pi  is  taken  to  be  the  layer  of  the  wire, 
pi  and  p3  must  be  uniquely  locatable  in  the  container  symbol,  sO.  The  width  of  the  generated  segment  is 
w.  If  not  NULL,  the  contact,  et,  is  placed  with  its  origin  at  the  intersection  of  the  horizontal  line  and  the 
generated  wire. 

•Ih(a0,bl,h3,wl,v3,ruv,ct)  >  aoa-plaaar  albow 

elb  generates  a  wiring  pattern  for  connecting  the  points  in  border  bl  with  the  points  in  border  b3. 
Wires  from  bl  will  have  width  wl,  wires  from  b3  will  have  width  w3.  The  pattern  generated  must  form 
an  elbow  but  it  is  not  necessary  that  bl  and  b3  be  on  the  same  layer.  The  contact,  ct,  will  be  placed  with 
its  origin  at  the  intersections  of  the  wires  from  bl  and  the  wires  from  b3  if  these  wires  are  not  on  the  same 
layer. 

The  rev  parameter  may  be  either  TRUE  (1),  or  FALSE  (0).  If  FALSE  the  connections  from  bl  to  b3 
will  be  in  the  normal  order  of  the  borders,  that  b,  low  order  points  in  bl  will  connect  to  low  order  points 
in  bS.  If  rev  b  TRUE,  the  connections  will  be  reversed,  that  b,  low  order  points  in  bl  will  connect  to  high 
order  points  in  b3. 

Through  combinations  of  selecting  subsets  of  the  borders  with  bdin  and  bdex  and  utilizing  the  normal 
and  reverse  options,  a  succession  of  elb  invocations  may  be  used  to  form  a  set  of  elbows  between  bl  and  b3 
which  implement  any  desired  ordering  of  the  connections. 
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t««(iO,bl,ba,v.r«v,ct}  -  tM 


te«  generates  a  wiring  pattern  for  connecting  the  indicated  border  of  the  tee  connected  symbol,  bl,  to 
the  wiring  in  the  transverse  routing  symbol  specified  in  the  border,  bfi.  The  wiring  in  the  routing  symbol  is 
assumed  to  run  perpendicular  to  the  wiring  generated  for  connecting  the  tee  connected  symbol.  The  routing 
symbol,  presumably  generated  by  a  prior  call  to  a  router,  is  also  assumed  to  consbt  strictly  of  paraUel  lines, 
no  elbows.  All  generated  wires  will  have  width  w.  The  contact,  et,  will  be  placed  with  its  origin  at  the 
intersection  of  the  generated  wires  and  the  wires  exuting  in  the  routing  symbol.  The  rev  parameter  is  set 
to  TRUE  if  the  connection  order  is  to  be  reversed. 

Through  combinations  of  selecting  subsets  of  the  borders  with  bdln  and  bdex  and  utilizing  the  normal 
and  reverse  options,  a  succession  of  tee  invocations  may  be  used  to  form  a  set  of  tee  patterns  between  bl 
and  b3  which  implement  any  desired  ordering  of  the  connections. 

All  of  the  non-planar  routers  have  a  contact  argument.  The  provsion  for  positioning  this  contact  in 
generated  routing  is  coordinate  dependent  in  that  the  contacts  are  always  positioned  so  that  their  origins, 
coordinate  (0,0),  coincides  with  the  intersections  of  wires  on  different  layers.  It  the  contacts  are  symetric 
and  generated  with  the  CFL  box  primitive,  as  is  the  case  with  the  NMOS  macros  gb  and  rb,  the  origins 
will  be  in  the  geometric  centers  because  the  box  primitive  is  designed  to  make  boxes  which  are  symetric 
about  the  origin  whenever  possible.  If  other,  asymetric,  forms  of  contacts  are  needed  they  may  be  generated 
according  to  the  above  criterion  using  the  CFL  wire  facility  described  in  Chapter  6. 

4.3  Routing  to  Library  Symbols 

Use  of  the  routers  generally  requires  that  three  pointers  into  a  symbol  heirarchy  be  supplied  •  the  container 
and  the  two  symbob  to  be  connected.  When  symbob  are  retrieved  from  the  library  using  gn  only  one  pointer 
is  provided.  A  typical  problem  of  thb  form  b  to  retrieve  from  the  library  both  a  complete  circuit  and  a  pad 
frame  and  then  to  connect  the  circuit  to  the  pads.  The  CFL  procedure  locate  may  be  used  to  obtain  a 
pointer  to  any  uniquely  named  sub'symbol  within  a  symbol  hebarchy.  All  symbob  saved  with  ps  are  named 
symbob. 

For  example,  the  following  program  places  an  experimental  CMOS  regbter  called  reg.4>lun  in  a  pad 
frame  and  connects  the  pads.  The  program  illustrates  a  number  of  the  routing  facilities  of  CFL. 

The  pad  frame  for  thb  chip  was  generated  using  the  CMOS  pad  frame  generator  described  in  man  pads. 

The  program  begins  by  reading  in  the  regbter  and  pad  frame  using  g*.  Note  that,  provided  they  are 
available,  only  the  border  descriptions  are  read  •  not  the  geometry  files. 

Since  there  are  connections  on  all  four  sides  of  the  regbter,  it  b  necessary  to  extend  the  points  where  the 
wbes  connect  somewhat  to  prevent  wiring  generated  for  adjacent  sides  from  colliding.  The  amount  of  thb 
extension  was  determined  empirically  using  Caesar  to  view  the  results  of  the  triab. 

The  pad  frame  has  subcelb  for  its  left,  right,  bottom  and  top  sides  called  'reg^adsJ',  ‘reg.padsj’, 
‘reg4>ads.b’,  and  ‘reg.pads.t’.  Pointers  to  these  subcelb  are  obtained  using  locate  and  border  descriptors 
are  constructed  for  theb  innermost  sides. 

Next,  border  descriptors  are  constructed  for  the  sides  of  the  regbter.  Note  that  the  SYMBOL  reg  now 
contains  both  the  original  regbter  and  the  extensions,  cc  b  used  to  place  the  regbter  in  the  center  of  the 
pad  frame  forming  the  SYMBOL  reg.xblp. 

The  planar  router  parameters  mlniet  and  arcoff  are  set  to  5  using  praet  since  the  routing  b  being  done 
on  the  'metal2'  layer.  Then  pr  b  used  to  generate  the  connections  for  the  four  sides. 

Finally,  regjchlp,  which  now  includes  the  pad  frame,  the  regbter,  and  the  routing  b  saved  using  pa.  The 
program  in  thb  example,  which  generates  connections  to  most  of  the  pins  on  an  84  pin  pad  frame,  executes 
in  about  2  seconds.  Abo,  as  long  as  any  modifications  to  the  design  of  the  regbter  do  not  affect  the  number 
and  order  of  its  external  connections,  thb  same  program  may  be  used  without  modification  to  assemble  the 
chip. 
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•inclnd*  <stdlo.h> 
tisclnda  "cfl.h* 


aaiaO 

< 


STHBOL  *padn,  *r*g,  *r«g_eliip; 


B0BDE&  *bpl,  •bpr,  *bpfe,  «bpb; 
BORDEK  *brl,  *brr,  •brt,  *brb: 


cf lntnrt(*eaon-p«") ; 


/«  Obtain  pad  fraaa  and  raglatar 


pada  -  ga(*rag_pada*): 

rag  ■  ga(*rag.plaa*): 


/•  Extaad  taralaala  of  tho  raglatar 


rag  *  oa(rag,axt(bd(rag,  "laft".  "aatalB*).  IdOO,  8)) 
rag  >  aa(rag.axt(bd(rag.  "right*,  *aatal2*),  idOO,  8)) 
rag  *  oo(rag.axt(bd(rag,  *bot*,  *aatal2*),  UOO,  8)) 
rag  ■  oo(rag,axt(bd(rag,  "top*.  'aatalB*),  1400,  6)) 


/*  Coaatraet  bordar  dattriptioat  for  tba  pad  fraaa 


•  bd(lo€ata(pada,*rag_pada_l*},  "right*,  *aatal3*): 
>  bd(laeata(pada,*rag.pada_r"),  "laft",  "aataia*); 

■  bd(loeata(pada,*rag_pada_b*),  "top",  *aotal2*): 

■  bd(loeata(pada,"rag_pada_t*),  "hot",  "aataU"); 


/•  Coaatraet  bordar  daaeriptloaa  for  tho  raglatar 


brl  •  bdCrag,  "laft",  "aatalS"); 
brr  -  bdCrog,  "right",  "aataia*); 
brb  ■  bd(rag,  "bat",  "aataU"); 
brt  ■  bdCrog,  "top",  "aataia*); 


/•  Placa  tha  raglatar  la  tha  caatar  of  tha  pad  fraaa 


rag_ehip  ■  ce(pada,rag} ; 


/*  Coanact  tha  raglatar  to  tha^pada 


praat(6,6); 

rag_ehip  ■  oo(rag_ehlp,  pr(rag_ehlp,  bpl,  brl, 8)) 
rag_ehip  ■  oo(rog_ehlp,  pr(rog_chlp,  bpr,  brr, 8)) 
rag_ehlp  ■  oo(rag.chip,  pr(rog_chlp,  bpb,  brb, 8)) 
rag.ehip  ■  oo(rag_chlp,  pr(rog_ehlp,  bpt,  brt, 6}) 


pa(*rag_ehlp*,rag_ehip) ; 


ef  latopO ; 
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5  Macros 

CFL  has  two  groups  of  macros  -  technology  independent  macros  and  technology  dependent  macros.  Cur¬ 
rently,  all  of  the  technology  dependent  macros  are  NMOS.  The  technology  independent  macros  are  - 


alpha (a, layer,*) 


charaetar  atrlag,  vidth  v 


croaa (layarl , dxl , dyl , 
Iayar2,d:d,dy2) 


two  boxaa,  eaatara  allgaad 


lattarCe, layer,*) 

laa(layar,*,dx,dy) 
la*(layar , * , dx, dy) 
leaf layer, *,dx,dy) 
la* (layer, *,dx,dy) 


alphaaaaarle  latter,  *idth  * 
latter 

el,  north  aaat 
el.  north  aaat 
el,  aenth  aaat 
al.  aeath  aaat 


alpha  generates  a  string  of  characters  which  are  5w  wide,  8w  high  with  2w  spacing  in  between.  The 
same  rules  apply  to  letter.  The  character  set  that  b  available  b 


A  -  Z 
0  -  » 

-  .  .  :  :  ?  I  /  I  ]  ♦  = 


Currently,  space  (or  blank)  b  not  available  and  neither  are  lower  case  letters. 
The  NMOS  macros  are  - 


baO 

- 

batting  contact,  aaat 

bnO 

- 

butting  contact,  north 

bsO 

- 

batting  contact,  aonth 

b*() 

” 

batting  contact.  *aat 

KbO 

- 

diffneioa  -  natal  contact 

rbO 

- 

poly  -  natal  contact 

padalno(dx,dy) 

- 

pad  fraso  albo*,  north  oaat  corner 

pndaln«(dx,dy) 

- 

pad  frano  albo*,  north  *ast  corner 

pndalso(dx,dy) 

- 

pad  frana  albo*,  aonth  aaat  corner 

pndala*(dx,dy) 

- 

pad  frana  albo*,  aonth  *oat  eornor 

pndaxt(dx) 

- 

pad  frana  axtanaion 

pnllnp(l,dir) 

- 

pnllnp,  length  and  diraetion 

There  are  three  NMOS  pads  (input,  output  and  tri-state)  that  are  designed  to  fit  on  the  pad  fr.'.me. 
These  pads  are  not  CFL  macros  but  are  available  as  library  ceUs. 

The  pullup  has  a  minimum  gate  width. 
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6  Wire  Facility 

To  provide  for  the  parametric  generation  of  particularly  complex  leaf  cells,  or  cells  with  specific  coordinate 
requirements  like  router  contacts,  CFL  includes  the  wire  facility  which  allows  the  use  of  symbol  relative 
coordinates.  Note  that  the  use  of  this  facility  can  intorduce  significant  coordinate  dependency  into  a  design 
so  it  should  not  in  general  be  used  in  cases  where  the  relative  operators  are  able  to  serve.  The  procedures 
associated  with  the  wire  facility  are  the  following  > 


wlrn (layer , width) 

at(xO.yO) 

dx(dxO) 

dy(dyO) 

iao(n) 

wl( layer) 

ww (width) 

x(xO) 

y<y0) 


Initialize  a  wire 
Move  to  the  point  (xO.yO) 
Draw  to  tho  point  (x^dxO.y) 
Draw  to  the  point  (x,y«dyO) 
Inelnde  nynbol  origin 
Renat  tho  wire  layer 
Roiot  tho  wire  width 
Draw  to  tho  point  (xO.y) 
Draw  to  the  point  (x.yO) 


wire  is  of  type  SYMBOL  *.  All  of  the  procedures  apply  to  the  wire  generated  by  the  last  caU  to  wire. 
Note  that  the  symbol  generated  by  wire  may  contain  an  arbitrary  number  of  physical  ‘wires’  which  need 
not  be  connected.  The  only  thing  they  have  in  common  is  their  coordinate  system. 

The  procedure  Uo  has  a  symbol  as  its  argument,  iao  includes  that  symbol  positioned  so  that  its  origin 
coincides  with  the  current  wire  position.  Note  that  the  current  wire  position,  or  more  preebely,  the  position 
within  the  coordinate  system  of  the  current  wire,  b  initialized  with  the  at  procedure  and  maintained  by  all 
move  and  draw  procedures. 
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7  Running  CFL 

Currently  CFL  is  installed  in  lUW.VLSI.TOOLS.  It  consists  of  two  files,  $UW.VLSI.TOOLS/include/cfi.h 
and  $UW.VLSI.TOOLS/lib/Iibcfl.a.  efl.h  must  be  included  in  any  pro^am  that  intends  to  use  CFL  facili¬ 
ties.  When  compiled  this  program  must  be  linked  with  llbefl.n.  Application  programs  may  achieve  access 
to  CFL  by  including  the  line 

iinelndn  "efl.h* 


in  soucre  modules  which  reference  CFL  facilities.  These  modules  may  then  be  compiled  and  linked  using  the 
following  command  line: 


ce  nodnln.e  $UW.VLSI.T00L8/llb/llbefl.a  -I$OV_VLSI_TOOL8/lnclndn 


When  executed,  a  CFL  program  will  attempt  to  reference  the  sub-directory  ./ca  of  the  current  directory 
for  both  reading  and  writing  symbob.  It  will  not  create  this  directory  if  it  does  not  exist,  so  prior  to  using 
CFL,  this  sub-directory  must  be  created. 


7.1  Diagnostic  facilities 

CFL  contains  a  number  of  internal  checks  for  parameter  range  and  consistency,  successful  completion  of  the 
routers,  access  to  data  files,  etc.  A  failure  of  any  of  these  checks  will  abort  the  application  program  with 
an  error  message  describing  the  condition  that  caused  the  error  and  the  name  of  the  routine  in  which  the 
error  occurred.  As  this  latter  routine  will  probably  be  a  CFL  internal  routine  not  directly  called  by  the 
application,  the  CFL  error  handler  will  abo  Ust  the  last  8  application  level  routines  called  before  the  error 
occurred.  These  routines  are  Ibted  in  the  reverse  of  the  order  in  which  they  were  called. 

Thb  information  b  hopefully  sufficient  to  indicate  the  last  point  of  successful  execution  in  the  application 
as  well  as  the  cause  of  the  error.  In  cases  where  more  information  b  needed  the  the  call 


prtaynboKn) ; 


may  be  used  to  output  the  internal  structure  corresponding  to  the  symbol  a  on  the  standard  output. 

The  most  frequent  types  of  errors  tend  to  be  mbmatches  between  what  b  thought  to  be  on  a  border  of  a 
symbol  and  what  b  actually  there.  Dbcrepencies  arbe  easily  since  a  single  piece  of  material  which  extends 
beyond  the  intended  border  causes  all  other  crossings  to  be  dropped  by  expanding  the  bounding  box.  In  the 
case  of  persbtent  errors  it  has  usually  been  necessary  to  modify  the  problem  program  to  output  intermediate 
symbob  using  pn  and  then  to  view  these  symbob  using  Caesar. 

The  most  difficult  to  debug  errors  are  those  which  cause  something  in  the  CFL  library  to  abort  without 
calling  the  error  handler.  Thb  can  happen  if  a  routine  b  called  with  the  wrong  number  of  arguments, 
if  an  attempt  b  made  to  use  a  temporary  SYMBOL  pointer  invalidated  by  a  call  to  cflcollect,  or  if  the 
array  argument  passed  to  one  of  the  vector  operators  b  not  really  as  long  as  the  call  indicates.  To  help 
manage  errors  of  thb  latter  category,  it  b  helpful!  if  larger  systems  are  decomposed  into  small  independently 
verifyable  sections. 
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7.2  Remindera 

1.  All  dx  and  djr  coordinates  are  dimensionless  integer  values. 

2.  All  layer  arguments  are  alphanumeric  layer  names  for  the  technology  being  used. 

3.  All  primitives,  macros,  and  operators  are  declared  SYMBOL  *  in  cfl.h  and  return  pointers  to  the 
symbols  they  create. 

4.  The  CFL  library  contains  a  large  number  of  operators  which  are  automatically  declared  by  the  cfl.h  file. 
As  most  of  these  names  are  short,  potential  naming  confiicts  arc  likely  between  the  CFL  operators  and 
the  application's  variables.  To  help  avoid  this  problem,  none  of  the  names  reserved  by  CFL  contains 
a  digit.  Hence  variables  may  be  safely  named  boxl,  box2,  and  so  on. 

5.  A  quick  way  to  get  a  complete  up  to  date  listing  of  all  CFL  facilities  alphabetically  arranged  by  category 
with  a  one  line  description  for  each  u  eat 
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8  Appendix 

This  Appendix  lists  all  of  the  CFL  functions  described  in  this  manual.  The  functions  are  arranged 
alphabetically  and  grouped  in  accordance  with  the  chapters  of  the  manual. 


/«  Data  coaatructora  «/ 


border  *bd(a,alda,layaraaBa)  /•  ayabolle  bordar  daacriptor  */ 

STMBOL  *a; 
char  •■Ida: 
char  *layaraaBa: 

BORDER  •bdax(bl,i)  /«  axclsda  1  froa  bordar  daacriptor  */ 

BORDER  «bl; 
iat  1; 

BORDER  «bdin(bl,l)  /*  lacluda  1  la  bordar  daaerlptor  */ 

BORDER  «bi; 
iat  1; 

iat  f(r)  /«  eoavart  floatiag  argnaaat  «/ 

float  r: 

PT  *pt(a,oida,layoraaBa,B)  /«  ayabolle  poiat  «/ 

STMBOL  *a: 

char  *slda; 

char  *layaraaaa ; 

iat  a; 


/«  Oparatora  */ 


STMBOL  *bb(al.a2)  /*  align  bottoa  to  bottoa  */ 

STMBOL  *al.*o2: 

STMBOL  *bbdx(ai,a2,dx)  /*  align  bottoa  to  bottoa,  x  offaot  */ 

STMBOL  «al,*aa: 
iat  dx; 

STMBOL  *bbdxy(al,B2,dx,dy)  /•  aliga  bottoa  to  bottoa,  xy  offaot  */ 

STMBOL  *ai,*a2; 
iat  dx,dy; 

STMBOL  *bbdy(al,a2,dy)  /*  align  bottoa  to  bottoa,  y  offaot  */ 

STMBOL  •al,*s2; 
iat  dy; 

STMBOL  *bx(al,a2)  /*  pair  la  x,  bordara  allgnad  */ 

STMBOL  «ol,*a2; 
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SYMBOL 

*bxdx(al,a2,dx) 

/• 

pair  ia  x,  bordara  aligaad.  x  offaat 

*/ 

SYMBOL 

•al.*a2: 

iat 

dx; 

SYMBOL 

*bxdxy (al , a2 , dx, dy) 

/* 

pair  la  x,  bordara  allgaad.  xy  offaat 

*/ 

SYMBOL 

*al,*a2: 

iat 

dx.dy: 

SYMBOL 

*bxdy(al,a2,dy) 

/• 

pair  in  x.  bordara  aligaad.  y  offaat 

•/ 

SYMBOL 

*il.*a2; 

iat 

dy: 

SYMBOL 

*by(al,a2) 

/• 

pair  la  y.  bordara  aligaad 

•/ 

SYMBOL 

*al,*a2: 

SYMBOL 

*bydx(al,a2,dx) 

/• 

pair  ia  y,  bordara  aligaad,  x  offaat 

•/ 

SYMBOL 

*al,*a2: 

Iat 

dx; 

SYMBOL 

*bydxy(al,a2,dx,dy) 

/• 

pair  ia  y,  bordara  aligaad.  xy  offaat 

*/ 

SYMBOL 

*al,«a2: 

lat 

dx.dy; 

SYMBOL 

•bydy(al.a2.dy) 

/• 

pair  la  y.  bordara  allgaad.  y  offaat 

*/ 

SYMBOL 

*al.«a2: 

iat 

dy: 

SYMBOL 

*ee(ai,a2) 

/• 

align  caatar  to  cantor 

*/ 

SYMBOL 

*ai,*a2; 

SYMBOL 

«cedx(al,a2,dx} 

/• 

aliga  caatar  to  caatar,  x  offaat 

•/ 

SYMBOL 

*ai.*a2; 

lat 

dx; 

SYMBOL 

*ccdxy(al,a2, dx.dy) 

/• 

align  caatar  to  caatar.  xy  offaat 

•/ 

SYMBOL 

*al.*a2; 

iat 

dx.dy; 

SYMBOL 

•cedy(al.a2.dy) 

/• 

aliga  caatar  to  caatar,  y  offaat 

•/ 

SYMBOL 

«al.*a2; 

iat 

dy; 

SYMBOL 

•ep(ai.pl) 

/• 

align  caatar  to  point 

•/ 

SYMBOL 

••1: 

PT 

•Pl: 

SYMBOL 

•epdx(al.pi.dx) 

/• 

aliga  cantor  to  point,  x  offaat 

*/ 

SYMBOL 

••1; 

PI 

*pl; 

iat 

dx; 

SYMBOL 

*epdxy(al. pi. dx.dy) 

/• 

aliga  caatar  to  point,  xy  offaat 

•/ 

SYMBOL 

••1; 
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fa 

PI  ‘pi: 

Int  dx.dy: 

R 

SYMBOL  *epdy<il,pl.«iy) 

SYMBOL  *■!: 

PT  ‘pi: 

/•  align  cantar  to  point,  y  off oat 

*/ 

1 

int  dy: 

»*•  ' 

SYMBOL  *cx(il.i3) 

SYMBOL  «nl,*ia: 

/*  pair  in  x.  cantor  aligned 

*/ 

i 

i  * 

SYMBOL  *cxdx(nl,na,dx) 

SYMBOL  *nl.*na: 
int  dx: 

/•  pair  in  x,  cantor  aligned,  x  of feat 

•/ 

SYMBOL  *cxdxy(al.aa.dx,dy) 

/*  pair  in  x,  cantor  aligned,  xy  of foot 

•/ 

SYMBOL  •al.MS: 

it 

int  dx.dy: 

SYMBOL  «cxdy(al.aa,dy) 

/♦  pair  in  x,  cantar  aligned,  y  of feat 

•/ 

SYMBOL  «ai,*a2; 

int  dy: 

i 

SYMBOL  •ey(al,aa) 

SYMBOL  *al,«a2: 

/*  pair  la  y.  cantar  aligaad 

•/ 

’•  •  ■ 

SYMBOL  *eydx(al,aa,dx) 

/•  pair  In  y,  cantor  aligaad.  x  of feat 

*/ 

SYMBOL  *ai.«a2; 

int  dx; 

SYMBOL  •cydxy<nl.a2.dx.dy) 

/•  pair  la  y.  cantor  aligaad.  xy  offaat 

*/ 

t*’  V 

SYMBOL  *al,*a2; 

int  dx.dy; 

'-V- . 

SYMBOL  *cydy(al,a3,dy) 

/•  pair  in  y.  cantor  aligned,  y  offaat 

*/ 

m 

■eU-. 

SYMBOL  «nl,*a2; 

.*-%  - 

int  dy; 

SYMBOL  «ll(ai,a2) 

/*  align  loft  to  loft 

•/ 

SYMBOL  *ai,*aa; 

• 

T'--' 

SYMBOL  *lldx(al,a2,dx} 

SYMBOL  •ai.*a2; 

/«  align  loft  to  loft,  x  offaat 

•/ 

1“'  ■- 

int  dx; 

k‘*  •'*. 
k'v.'v 

SYMBOL  *lldxy(al,a2, dx.dy) 

/•  align  loft  to  loft,  xy  offaat 

•/ 

►  **-*..■ 

SYMBOL  •al.*n2; 

int  dx.dy; 

SYMBOL  *lldy(al.aa.dy) 

/*  align  loft  to  loft,  y  of foot 

•/ 

•  *,  *' 

SYMBOL  •al.*a2; 

int  dy; 

k  '• 

m 

SYMBOL  •■x(a) 

/•  nlrror  in  x 

•/ 

rn^.- 
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STMBOL 

•a: 

STMBOL 

*ay(i) 

/• 

airror  ia  y 

•/ 

STMBOL 

*■: 

STMBOL 

*ax(a,a) 

/• 

rapaat  ia  x 

*/ 

STMBOL 

iat 

a: 

STMBOL 

*axdx(a , a , dx) 

/* 

rapaat  ia  x,  x  apaciag 

*/ 

STMBOL 

*•; 

iat 

a; 

iat 

dx; 

STMBOL 

*axy(a,ax,By) 

/• 

rapaat  in  x  aad  y 

•/ 

STMBOL 

•a; 

iat 

ax. ay: 

STMBOL 

* axydxy ( a , ax , ay . dx , dy ) 

/• 

rapaat  ia  x  aad  y.  xy  apaciag 

•/ 

STMBOL 

•a; 

iat 

BX.ay; 

iat 

dx.dy; 

STMBOL 

*ay(a,a) 

/* 

rapaat  ia  y 

•/ 

STMBOL 

•a; 

iat 

a; 

STMBOL 

*aydy(a,a,dy) 

/• 

rapaat  ia  y,  y  apaciag 

•/ 

STMBOL 

•a: 

iat 

n; 

iat 

dy: 

STMBOL 

*oa(al,a2) 

/• 

align  origin  to  origin 

*/ 

STMBOL 

♦al.*a3; 

STMBOL 

*oodx(al,a2,dx) 

/* 

align  origin  to  origin,  x  offaat 

*/ 

STMBOL 

•al.*a3: 

iat 

dx: 

STMBOL 

*oodxy (al , a3 , dx, dy) 

/• 

aliga  origin  to  origin,  xy  offaat 

*/ 

STMBOL 

*al,*a3; 

iat 

dx.dy; 

STMBOL 

*oody(al,a3,dy) 

/• 

align  origin  to  origin,  y  of foot 

•/ 

STMBOL 

•al,*a3: 

iat 

dy: 

STMBOL 

*pax(al,al,a3,a3,layarnaaa)  /•  poiat  align  ia  x 

•/ 

STMBOL 

*al,*a3: 

iat 

al,a3: 

char 

*layarnaaa; 

STMBOL 

*paxdx(ai,Bl,a3,a3,layarBaBa.dx)  /*  point  align  ia  x,  x  offaat 

•/ 

STMBOL 
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iat 

al.aS: 

char 

*layaraaaa: 

iat 

dx; 

SYMBOL 

*paxdxy(ai,ai,s2.a2,layaraaBa,dx,dy)  /*  poiat  align  ia  x.  xy  offaat 

•/ 

SYMBOL 

*al,«aa; 

Iat 

ai.aS; 

char 

«layarnana; 

iat 

dx.dy: 

SYMBOL 

*paxdy(si,al,a2,a2,layaraaaa,dy)  /«  poiat  align  in  x,  y  offaat 

•/ 

SYMBOL 

*oi.*aa: 

Iat 

nl.aa: 

char 

*layoraaaa: 

iat 

dy; 

SYMBOL 

*pay(oi,al,aa,aa,layornaao)  /•  poiat  align  in  y 

*/ 

SYMBOL 

••i.*a2: 

iat 

al,a2: 

char 

*layarnano: 

SYMBOL 

*paydx(oi,ai,aa.n2,layarBaaa,dx}  /•  point  align  in  y,  x  offaat 

•/ 

SYMBOL 

*al,*ia; 

iat 

nl.na: 

char 

*layoraaao: 

iat 

dx: 

SYMBOL 

*paydxy(al,nl,a2.n2,layaraaBO, dx.dy)  /•  point  align  in  y,  xy  offaat 

•/ 

SYMBOL 

*ai,*a2: 

iat 

ai.aS: 

char 

•layaraano; 

iat 

dx.dy; 

SYMBOL 

*paydy(ai.ai.aa,aa,layaraaBo.dy)  /*  poiat  align  ia  y,  y  offaat 

•/ 

SYMBOL 

*ai,*a2; 

iat 

ai,B2; 

char 

•layoraana; 

iat 

dy: 

SYMBOL 

*ropx(a,a,dx)  /*  ropoat  in  x.  npacial  pariod  dx 

•/ 

SYMBOL 

*•; 

iat 

n; 

iat 

dx: 

SYMBOL 

*ropxy(a,Bx.ny, dx.dy)  /•  ropoat  ia  x  and  y.  porioda  dx  dy 

•/ 

SYMBOL 

iat 

ax. ay: 

iat 

dx.dy; 

SYMBOL 

*rapy(a.a,dy)  /*  ropoat  ia  y.  apaeial  pariod  dy 

*/ 

SYMBOL 

•n; 

iat 

a; 

iat 

dy: 
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STMBOL  •rot(f,n) 

STMBOl  *■; 
iat  a; 

/*  rotata 

•/ 

STMBOL  *rr(nl.na) 

STMBOL  *il.*na: 

/•  allga  right  to  right 

•/ 

STMBOL  •rrdx(tl,ta,dx) 
STMBOL  *nl,«n2: 
int  dx; 

/•  allga  right  to  right,  x  of foot 

•/ 

STMBOL  *rrdx]r(nl,ta.dx,d7) 
STMBOL 

iat  dx.dy; 

/•  allga  right  to  right,  xy  of foot 

•/ 

STMBOL  *rTdy(al,a2.dy) 
STMBOL  •al,*aa; 
iat  dy: 

/*  align  right  to  right,  y  off not 

*/ 

STMBOL  «aa(al,aa) 

STMBOL  «al,*aa: 

/*  ayabol  naioa 

•/ 

STMBOL  *tt(al,aa) 

STMBOL  «al,*aa: 

/«  align  top  to  top 

•/ 

STMBOL  *ttdx(sl,sa,dx) 
STMBOL  *al,«aa: 
iat  dx; 

/•  allga  top  to  top,  X  offaot 

•/ 

STMBOL  •ttdxy(sl,aa, dx.dy) 
STMBOL  *al,*sa; 
iat  dx.dy; 

/*  align  top  to  top,  xy  offaot 

•/ 

STMBOL  *ttdy(al.a3.dy) 
STMBOL  «al.«aa: 
lat  dy; 

/*  allga  top  '.j  top,  y  offaot 

•/ 

STMBOL  *vx(a.a) 

STMBOL  «a[]; 
iat  a; 

/*  Toetor  la  x 

•/ 

STMBOL  *vxy(a,ax.ay) 

STMBOL  *a[]: 
lat  ax, ay: 

/*  voetor  ia  x  aad  y 

•/ 

STMBOL  *vy(a.a) 

STMBOL  ••[]; 
lat  a; 

/•  Toctor  ia  y 

•/ 

/*  CFL  eoatrol  aad  library  aeeaaa 

•/ 

lat  efleollaetO 

/«  eolloct  taaporary  ayabola 

•/ 
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Int  eflaate(n,T) 
eluir  *•; 
char  *▼; 

/*  aat  atriag  paraaatar 

*/ 

iat  cflastv(a,v) 
char  •a; 
iat  v; 

/•  cat  iatagar  paraaatar 

•/ 

iat  cflatart(tach) 
char  «taeh: 

/*  iaitialiaa  cfl 

•/ 

iat  cflatopO 

/*  taraiaata  cfl 

•/ 

STMBOL  *(a(eall) 
char  *call: 

/*  gat  library  ayabal 

•/ 

STMBOL  *(ap(call) 
char  *call: 

/*  gat  library  ayabal  «ith  prafix 

•/ 

STMBOL  •pa(r.a)  /«  pat  tTabol  ia  tha  apabol  tabla 

char  ‘y: 

STMBOL 

•/ 

STMBOL  *pap(7,a)  /« 

char  *y; 

STMBOL  *•: 

pat  ayabal  ia  tha  ayabal  tabla  with  prafix 

*/ 

/•  Bontara 

•/ 

STMBOL  *alb(a0,bi,b2,vl,v2.ct,rav)  /•  caapoaad  alba* 

*/ 

STMBOL  *80:  /« 

coataiaar  call 

•/ 

BOISEB  *bl;  /* 

bordar  of  taa  caaaactad  call 

•/ 

BOIOEB  *b2;  /• 

bordar  of  traaoToraa  roatiag  call 

•/ 

iat  *i.  /• 

vidth  of  viriag  froa  bl 

•/ 

•2;  /* 

width  of  viriag  froa  b2 

•/ 

STMBOL  'ct;  /• 

coatact  ayabal 

•/ 

iat  rav;  /• 

TBOl  if  alba*  la  to  ravarao  coaoactioa  ardor 

•/ 

STMBOL  «axt(b,4,«) 
BOIOEB  *b: 
iat  d: 

iat  *: 

/*  bordar  axtoadar 

•/ 

STMBOL  *fill(a,aida,d) 
STMBOL  •!; 
char  *8148; 
iat  d; 

/*  Caaaar  fill  oparator 

•/ 

STMBOL  •laeataCal.aS) 
STMBOL  *al: 
char  *82; 

/*  Locata  02  within  al. 

•/ 
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int  abe(b)  /«  Obtain  tba  anabar  of  ereoalnfo  on  tho  border  b  */ 
BOtoa  •b; 


STMBOL 

«plx(oO,pl,p2,»,et)  /•  poiat  to  lias  la  x 

•/ 

SYMBOL 

•oO; 

/•  eoatalaor  coll 

•/ 

PI 

•Pl: 

/•  syabolle  poiat  1 

•/ 

PT 

•p2; 

/•  oyabolle  poiat  2 

•/ 

lat 

w; 

/•  width 

•/ 

STMBOL 

♦et: 

/•  eoataet 

•/ 

STMBOL 

*ply(o0,pl.p2,o,ct)  /*  poiat  to  llao  la  y 

•/ 

STMBOL 

*a0: 

/•  eoatalaor  eall 

•/ 

PT 

•pi: 

/•  oyabolle  poiat  1 

•/ 

PT 

•p2: 

/•  oyabolle  poiat  2 

•/ 

int 

«: 

/•  width 

•/ 

STMBOL 

•et; 

/•  eoataet 

•/ 

STMBOL 

•pp(a0.pl,p2,«)  /*  poiat  to  poiat  roator 

•/ 

STMBOL 

•oO; 

/•  eoatalaor  eoll 

•/ 

PI 

*pi; 

/•  oyabolle  poiat  1 

•/ 

PI 

•pa; 

/•  oyabolle  poiat  2 

•/ 

lat 

»: 

/«  width 

•/ 

STMBOL 

•pr(oO,bl,ba,*)  /•  plaaar  roator 

•/ 

SYMBOL 

•oO; 

/•  eoatalaor  eoll 

•/ 

BOBOEK 

•bl: 

/•  border  of  oab^eoll  1 

•/ 

BOROER 

•b2: 

/•  border  of  oab-eoll  2 

•/ 

lat 

*: 

/•  width 

•/ 

PBOC  prootCainoop.areeff)  /•  sot  paraaotsrs  for  tbo  plaaar  rontor  •/ 


lat 

alaoop. 

/•  plaaar  roator,  alalaaa  soparatloa 

•/ 

areof f ; 

/•  plaaar  roator,  of foot  of  tho  flrat 

axe*/ 

STMBOL 

•too(a0,bl.b2,w, 

et,roY)  /•  too 

•/ 

STMBOL 

•sO: 

/• 

eoatalaor  eoll 

•/ 

BORDER 

•bl; 

/• 

border  of  too  coaaoetod  eel 

•/ 

BORDER 

•b2: 

/• 

border  of  traasvoroo  roatia 

•/ 

int 

•: 

/• 

width 

•/ 

STMBOL 

•et; 

/• 

eoataet  ayabel 

•/ 

lat 

row; 

/• 

ravoras  flag 

•/ 

/• 

IROB  -  roTorood  too 

•/ 

/• 

FALSE  -  forward  too 

•/ 

/•  Maeroo 

•/ 

STMBOL  •boO 

/•  batting  eoataet,  east 

•/ 

STMBOL  •baO 

/*  battlag  eoataet,  north 

•/ 

STMBOL  •bax(layor,dx,dy) 

/•  box 

•/ 

ehar  •layer : 
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Ittt  dx.dy: 

h 

STMBOL  «bn() 

/«  battlag  eaataet.  aanth 

•/ 

STMBOL  «bw() 

/«  battlag  eaataet.  vaat 

•/ 

1 

STMBOL  ^eroHdnynrl.dxl.dyl.laynra.dsd.dya)  /•  erosa 

•/ 

'» 

■ 

char  *layarl,*layara; 
lat  dxl.dyl; 
iat  tbd.dya; 

1 

STMBOL  *|b() 

/*  natal  diffaaiaa  eaataet 

•/ 

STMBOL  *labal(Baaa,dx,dy,poa) 
char  *BaBa: 
iat  dx.dy: 
iat  poa : 

/«  labal 

•/ 

1 

T 

STMBOL  *laa(layar,w,dx,dy) 
char  *layar: 
lat  «: 
iat  dx.dy: 

/*  al.  aartb  aaat 

•/ 

1 

s. 

c 

STMBOL  *lB¥(layar.w.dx,dy) 
char  *layar: 
iat  w: 
iat  dx.dy: 

/«  al,  aarth  want 

•/ 

STMBOL  *lBa(layar.v, dx.dy) 
char  *layar: 
iat  w; 
iat  dx.dy; 

/•  al,  aaatb  aaat 

•/ 

.4 

J. 

i 

STMBOL  *la«(layar.v. dx.dy) 
char  *layar; 
lat  v; 
lat  dx.dy: 

/*  al,  aaath  vaat 

*/ 

-■ 

STMBOL  •padalaa(dx.dy) 
iat  dx.dy: 

/*  pad  albav  -  aarth  aaat  caraar 

•/ 

1 

STMBOL  *padalB« (dx.dy) 
iat  dx.dy: 

/*  pad  albav  -  aarth  vaat  earaar 

•/ 

•«. 

STMBOL  *padalBa(dx.dy) 
lat  dx.dy: 

•/ 

i 

STMBOL  *padala«(dx.dy) 
iat  dx.dy: 

/*  pad  albav  -  aaath  vaat  earaar 

•/ 

» 

STMBOL  *padaxt(dx) 
iat  dx: 

/*  pad  frana  axtaaaioa 

•/ 

• 

i 

STMBOL  *pnllBp(l.a) 

/«  pallap 

•/ 

« 

^  If  , 

;■  •\‘*v'** 

vvvv 
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int  1; 
int  ■: 

STMBOL  *rb() 

/«  aetal  polyaillcoa  coatact 

*/ 

/•  Vlrn  facility 

•/ 

STMBOL  •alpha(a, layer, «) 
char  *a: 
char  «layar: 
iat  «: 

/*  atriag  of  alpha  charactara 

•/ 

lat  at(xO,yO) 
iat  xO.yO; 

/*  eat  the  «lra  peaitlea  to  (xO,yO) 

•/ 

lat  dx(dxO) 
iat  dxO; 

/•  draw  to  the  poiat  (x«dxO,y) 

•/ 

iat  dy(dyO) 
iat  dyO; 

/«  draw  to  tho  poiat  (x,y^dyO) 

*/ 

lat  iao(a) 

SYMBOL  *a; 

/«  iaclado  eyabol  orifia 

•/ 

STMBOL  «lattar(c, layer, v) 
char  c; 
char  * layer; 

/*  lottor 

•/ 

Int  u; 


iat  wl(layor) 
char  * layer; 

/*  reaet  wire  layer 

•/ 

STMBOL  «wira (layer, width) 
char  «layar; 
iat  width; 

/*  iaitlaliaa  wire 

*/ 

lat  ww(width) 
iat  width; 

/*  reeet  wire  width 

•/ 

iat  x(xO) 
iat  xO; 

/*  draw  to  tho  poiat 

(xO,y) 

*/ 

lat  y(yO) 
lat  yO; 

/•  draw  to  the  poiat 

(x,yO) 

•/ 
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Editing  VXiSI  Circuits  with  Caesar 


John  Outterkout 

Computer  Science  Division 
Electrical  Engineering  and  Computer  Sciences 
University  of  California 
Berkeley,  CA  94720 
415-642-0865 

Arpanet  address:  ousterhoutOberkeley 
Uucp  address:  ucbvax!onster 


This  M«r  outasl  eoncspeids  to  Coeiar  VII. 


1.  latroduetlon 

Caesar  is  an  interactive  system  for  creating  and  modifying  VLSI  circuit  designs.  It  is  baaed 
on  the  Mead  and  Conway  style  of  design,  and  produces  CIF  descriptions  (Caltech  Intermediate 
Form)  suitable  for  chip  fabrication.  Caesar  is  not  an  “intelligent”  design  system  in  the  sense  of 
understanding  design  rules,  electrical  properties,  or  even  connectivity.  It  is  just  a  geometry  editor 
that  allows  you  to  paint  pictures  of  VLSI  circuits  and  to  combine  pictures  hierarchically  into 
larger  designs. 

Caesar  runs  under  the  4.1  Berkeley  Distribution  of  VAX  Unix.  It  is  a  two  screen  system. 
One  screen,  called  the  text  dieplay,  may  be  any  standard  CRT  terminal  capable  of  running  the 
screen  editor  vi.  Caesar  is  invoked  from  this  terminal;  commands  are  typed  at  its  keyboard  and 
a  command  menu  and  several  statistics  about  the  chip  design  are  displayed  on  the  text  display. 
The  second  screen  is  called  the  graphiee  dixplay  and  is  used  to  display  in  color  a  piece  of  the  cir¬ 
cuit  being  designed.  The  graphics  display  can  be  any  of  a  variety  of  color  displays.  Caesar 
currently  supports  AED512,  AED767,  Metheus  Omega440,  Chromatics  7900,  or  Vectrix  displays 
connected  to  the  VAX  via  a  9600  band  RS232  line.  It  also  supports  Ramtek  9400  displays  with 
DMA  interfaces.  A  graphics  tablet  must  be  attached  to  the  color  display  (except  the  Chromatics, 
which  has  a  joystick).  The  tablet  must  have  a  four-button  cursor,  which  is  referred  to  here  as  the 
puck. 

S.  Gettiag  Startnd 

The  command  line  for  Caesar  has  the  form 

etexar  -gKgraphiet  port>  -t<t»btet  port>  •p<path>  -n 
•  m<  moniler  <|rye>  •d<dup/ay  type>  <file> 

All  of  the  switches  are  optional  and  have  reasonable  defaults.  The  -g  switch  indicates  the  name 
of  a  device  in  the  /dev  directory  that  should  be  used  as  the  graphics  display  port.  Thus,  if  the 
display  is  connected  to  the  machine  as  IdevfttykO,  then  type  esessr  -gttykO  (yon  may  leave  spaces 
between  the  “-g”  and  the  “ttyhO”  if  you  wish).  If  the  -g  switch  isn’t  supplied,  Caesar  will  look  in 
internal  tables  to  locate  the  nearest  AED  display  to  the  terminal  from  which  the  command  is 
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issued  (if  none  can  be  found,  /dev/null  will  be  used).  See  Section  24  for  details  on  how  Caesar 
picks  a  default  display.  The  >1  switch  is  used  to  give  the  name  of  a  port  to  use  for  reading  tablet 
data.  If  not  specified,  Caesar  makes  an  educated  guess  as  to  which  port  to  use.  If  the  'p  switch  is 
present  it  specifies  a  path  to  be  used  by  Caesar  for  file  lookups  (see  Section  15  for  a  discussion  of 
paths).  If  the  -p  switch  isn’t  specified,  then  a  default  path  of  is  used.  The  -n  switch  causes 
Caesar  to  run  in  non-interactive  mode;  see  Section  19  for  more  details  on  this.  The  -d  and  -m 
switches  are  used  to  select  the  type  of  display  you  are  using  (AED,  Jupiter,  Metheus,  etc.),  and 
the  type  of  color  monitor  attached  to  the  display;  see  Section  24  for  details.  If  <file>  is 
specifi^,  it  is  the  name  of  a  cell  to  be  edited.  If  <file>  isn't  specified,  Caesar  will  assume  you 
want  to  build  a  new  cell  from  scratch. 

When  it  starts  up,  Caesar  attempts  to  read  a  command  file  from  .eaeaar  in  the  home  direc¬ 
tory.  Whether  oi‘  not  it  finds  a  file  there,  it  next  tries  to  read  a  command  file  from  .eaeaar  in  the 
current  directory  Command  line  options  override  specifications  in  the  startup  file.  See  Section 
17  for  detailed  in:  ormation  on  command  files. 

In  order  to  use  a  tablet  with  the  color  display,  you  may  have  to  go  to  extra  effort  so  that 
Caesar  can  read  <  haracters  from  the  display’s  port.  If  the  display  is  hardwired  to  a  machine,  Cae¬ 
sar  will  work  fine  if  you  just  arrange  for  there  not  to  be  a  login  process  for  its  port.  If  there  is  a 
login  process  for  :he  port,  you'll  have  log  in  a  job  called  “sleeper”  on  the  color  display.  No  pasv 
word  is  required.  Sleeper  will  run  a  special  program  to  reset  the  terminal  so  Caesar  can  read  from 
it.  The  sleeper  irogram  is  extraordinarily  durable  (it  has  to  be  because  of  bnp  in  the  AED 
display).  The  on.y  way  to  kill  it  is  by  typing  two  control-backslash  characters  within  ten  seconds 
of  each  other.  O  i  the  .AEO  keyboard  control-backslash  is  control-shift-L.  On  most  Berkeley  sy^ 
terns,  you  can  aliO  kill  sleeper  jobs  from  other  terminals  by  typing  “killsleeper  <pid>''  where 
<pid>  is  the  pr<cess  id  of  the  sleeper  process.  On  some  systems,  you  have  to  log  yourself  in  and 
then  run  sleeper  ts  a  shell  command. 

Although  it  shouldn't  happen,  the  display  will  occasionally  get  itself  into  a  mode  where  Cae¬ 
sar  cannot  run.  When  this  happens,  reset  the  color  display.  On  AED’s,  this  is  done  by  hitting 
the  “reset”  key  t  vice  (it's  a  black  key  at  the  top  left),  after  which  you  should  hear  a  beep  and  see 
the  screen  go  blaik.  'To  be  absolutely  safe,  you  may  want  to  kill  the  sleeper  program  and  log  it 
in  again.  After  nsetting  the  display,  type  ‘“reset”  to  Caesar;  this  should  b  thinp  up  again. 

The  rest  of  this  manual  is  most  easily  understood  if  you  can  play  with  Caesar  as  you  read. 
From  now  on,  I  :ssume  that  you  are  sitting  in  front  of  a  terminal,  and  have  run  Caesar  with  the 
command  “caesai  shiftcell”  (shiftcell  is  a  cell  in  the  Caesar  library). 


3.  The  Command  Interface  and  Text  Display 

After  Caesar  starts  running,  the  text  screen  will  fill  with  characters  (see  Figure  1).  The  text 
display  is  divided  into  three  sections.  The  lower  right  portion  of  the  display  is  a  list  of  all  the 
akort  eommanda  along  with  brief  descriptions  of  their  functions.  Each  short  command  is  invoked 
by  typing  a  single  letter  on  the  keyboard.  Try  typing  the  g  short  command  (a  grid  should  turn 
on  and  off). 

The  lower  left  portion  of  the  text  display  gives  the  names  of  most  of  the  long  eommanda 
(the  color  map  commands  described  in  Section  23  were  omitted  for  lack  of  space).  A  long  com¬ 
mand  is  invoked  by  typing  a  colon  (";”)  followed  by  a  line  of  text,  followed  by  a  return.  The  line 
of  text  contains  the  name  of  a  command  and  any  parameters  that  are  need^  by  the  command. 
To  invoke  a  long  command,  yon  need  only  type  enough  characters  to  distinguish  it  from  the  other 
long  commands.  In  the  listing  of  long  commands  on  the  text  display,  the  minimum  set  of  charac¬ 
ters  that  must  be  typed  to  invoke  each  command  is  shown  in  UPPER  CASE.  Try  typing  the 
commands  mllgn,  ml,  m  (which  is  ambiguous),  and  tbadeommand  (which  is  not  a  command  at 
all).  The  long  commands  appear  on  the  bottom  line  of  the  text  display,  and  yon  may  edit  these 
lines  as  you  type  them  by  using  the  standard  Unix  editing  characters  such  as  kill  and  backspace. 

Each  long  command  may  actually  contain  several  long  commands  separated  by  semi-colons. 
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Caesar  VII  Technology: 

Editing  file:  shiftrow 

Current  cell:  shiftcell 

Current  view: 

Box  (alignment:  1) 

nmos 

Visible  Layers:  pdmibcoel 
-20 ,  15  20.5  •  120 

-20 ,  15  20.5  •  40 

-50  ,  0  150  •  143 

-16  .  10  32.5  •  2 

Long  Commands: 

Short  Commands: 

•Align 

Identify  c 

scroll 

t  •  Zoom  in  a  -  Yank 

ARray 

LAbel 

SEarch 

Z  -  Zoom  out  s  -  Stuff  (a>put) 

BOX 

LYra 

Sideways 

V  -  View  whole  chip  d  -  Delete  paint 

Button 

MACro 

source 

5  -  Center  view  on  box  LL 

Clf 

MARk 

subedit 

6  -  Center  view  on  box  UR 

CLOCkwise 

MOvecell 

Technolog 

'L-Redraw  color  screen 

COPycell 

PAInt 

UPsidedow 

1  •  Redraw  both  screens 

Deletecel 

PATh 

USage 

.  -  Repeat  last  long  command 

EDitcell 

PEek 

VIEW 

C  •  Expand  current  cell 

ERasepain 

POpbox 

VISiblela 

c  -  Unexpand  current  cell 

Fill 

PUShbox 

Width 

X  -  Expand  area 

FL  ushcell 

PUT 

WRiteall 

X  -  Unexpand  area 

GEtcell 

Quit 

YAnk 

qwer  -  Box  left,  right,  up,  down 

GRIDspaci 

RESet 

YCeU 

u  -  Undo  last  modification 

GRlPe 

Height 

RETurn 

SAvecell 

YSave 

g  *  Tog^e  grid  on/off 

Flgur*  1.  A  sample  view  of  the  Caesar  text  display. 

This  feature  is  particularly  useful  io  writing  macros  (see  Section  16).  To  include  a  semMolon  as 
part  of  a  long  command,  rather  than  as  a  separator,  type  instead  of  If  a  long  command 
consists  of  a  single  quote  followed  by  another  character,  the  character  is  used  as  a  short  com* 
maud.  For  example,  the  long  rommand  t'n  is  equivalent  to  the  short  command  'a.  This  feature 
is  useful  for  macros  and  command  Oles. 

The  top  portion  of  the  (ext  screen  contains  several  statistics  about  the  cell  being  edited. 
These  will  be  explained  in  later  sections. 

All  error  messages  are  typed  on  the  bottom  line  of  the  text  screen.  If  several  errors  occur 
simultaneously,  a  mechanism  like  that  of  the  more  program  is  used  to  prevent  one  message  from 
getting  overwritten  by  subsequent  ones.  The  first  message  is  printed,  then  “-More-"  appears  at 
the  end  of  the  bottom  line  of  the  text  screen.  After  you  have  read  the  first  message,  type  a  space 
character  to  see  the  next  message.  To  see  how  this  works,  type  the  long  command  xjrube. 

Whenever  Caesar  makej  any  modifications  to  the  cell  database,  it  saves  enough  information 
to  undo  the  effects  of  the  most  recent  modification.  If  you  discover  that  you  have  changed  some¬ 
thing  yon  didn’t  really  want  to  change,  type  the  short  command  u  to  undo  it.  Undo  applies  to 
the  last  command  that  changed  the  database,  including  itself. 


4.  Thu  Box  and  Crosshair 

When  you  invoked  Caesar,  a  picture  of  an  NMOS  shift  register  cell  should  have  appeared  in 
the  middle  of  the  color  display,  along  with  a  white  box  and  a  blinking  crosshair.  If  you  move  the 
puck  around  on  the  tablet,  the  crosshair  will  move  around  on  the  screen.  The  crosshair  and  the 
box  are  used  as  toolt  to  invoke  Caesar  commands;  they  are  not  part  of  the  circuit.  Most  of 
Caesar’s  commands  operate  in  some  way  or  other  on  the  area  selected  by  the  box.  The  crosshair 
is  used  to  position  the  box  and  to  select  mask  layers  and  subcells. 
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The  current  position  and  size  of  the  box  are  displayed  in  the  upper  portion  of  the  text 
screen.  The  four  numbers  on  the  right  side  of  the  line  labeled  “Box”  are,  from  left  to  right,  the 
x-coordinate  and  y*coordinate  of  the  lower-left  corner  of  the  box,  and  the  x-size  and  y-size  of  the 
box.  The  units  used  in  Caesar  correspond  to  the  lambda  units  of  Mead  and  Conway.  The  preci¬ 
sion  of  Caesar  units  is  .5  lambda,  which  is  in  keeping  with  the  smallest  features  of  the  Mead  and 
Conway  design  rules. 

Two  of  the  buttons  on  the  puck  are  used  to  position  the  box.  When  the  left  (white)  button 
on  the  puck  is  depressed,  the  whole  box  is  moved  so  that  its  lower-left,  or  fixed,  corner  coincides 
with  the  location  of  the  crosshair.  The  right  (green)  puck  button  positions  the  upper-right,  or 
variable,  corner  of  the  box  without  changing  the  lower-left  comer. 

The  box  can  have  zero  (or  even  negative)  size.  When  it  has  zero  size  it  appears  as  a  cross 
rather  than  as  a  rectangle. 

When  positioning  the  box  with  the  crosshair,  the  crosshair  position  is  rounded  off  to  the 
nearest  lambda  unit.  This  alignment  factor  is  dispbyed  on  the  “Box"  line  of  the  text  display. 
To  change  it,  type  the  long  command 

inUgn  <nUt> 

which  will  set  the  alignment  factor  to  <size>  units.  <size>  is  rounded  off  to  the  nearest  power 
of  two,  and  cannot  be  less  than  .5.  As  part  of  the  a:tion  of  mllgn,  the  box’s  coordinates  are  re¬ 
aligned  to  the  units  specified.  <size>  defaults  to  one  lambda. 

There  are  a  few  additional  long  commands  that,  can  be  used  to  position  the  box.  The  conH 

mand 

:box  <ke3rword>  <nmount> 

will  adjust  the  size  and/or  position  of  the  box  by  <amount>  units,  according  to  <  keyword  >. 
If  <keyword>  is  'up”,  “down",  “left",  or  “right",  then  the  box  is  moved  in  the  specified  direc¬ 
tion.  If  the  keyword  is  “xbot",  “xtop”,  “ybot”,  or  “ytop”,  then  the  size  of  the  box  is  changed  by 
adding  <amount>  to  its  lower  or  upper  x-  or  y-cocrdinate.  The  amount  may  be  negative.  As 
usual,  unique  abbreviations  for  the  keywords  are  acceptable.  The  short  commands  q,  w,  n,  and  r 
are  equivalent,  respectively,  to  tbox  Inft  1,  sbox  riglit  1,  tbox  up  1,  and  tbox  down  1. 

The  long  commands 

xhsigbt  <sl)sn> 
iwidth  <nh.n> 

may  be  used  to  set  the  box's  height  and  width  to  specific  sizes.  The  upper-right  (variable)  comer 
of  the  box  is  moved  so  that  the  x-  or  y-dimesion  is  net  to  <size>  units.  If  <size>  is  preceded 
by  a  “+  "  character  then  the  box’s  size  is  changed  by  moving  the  lower-left  (fixed)  comer' rather 
than  the  upper-right  one.  <size>  defaults  to  2  units. 


6.  Pmlntlng  Commands 

Caesar’s  mechanism  for  creating  mask  designs  is  much  like  painting.  The  two  basic  open^ 
tions  are  to  paint  one  or  more  mask  layers  over  the  area  of  the  box,  and  to  erase  one  or  more 
mask  layers  from  the  area  of  the  box.  You  should  think  of  the  mask  information  as  paint;  it  has 
no  stracture  other  than  its  color  and  shape  (for  example,  it  doesn’t  make  sense  to  think  about 
mask  information  as  objects  such  as  rectangles  or  polygons;  it  is  just  a  structureless  blob). 

There  are  several  ways  to  paint  and  erase.  The  simplest  way  is  to  use  the  bottom  (blue) 
button  on  the  pock.  First,  use  the  left  and  right  buttons  to  position  the  box  over  the  area  you 
wish  to  paint.  Then  move  the  crosshair  over  an  existing  piece  of  the  design  and  press  the  bottom 
button.  The  area  under  the  box  will  be  painted  in  whatever  mask  layers  are  present  underneath 
the  crosshair.  If  there  is  no  paint  underneath  the  crosshair,  then  the  area  of  the  box  is  erased. 
Try  painting  a  diffusion  (green)  rectangle,  then  erase  a  small  hole  in  the  middle  of  it.  Remember 
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that  the  painting  commands,  as  well  as  any  other  commands  that  change  the  database,  can  be 
undone  with  the  u  short  command. 

Painting  can  also  be  invoked  from  the  keyboard.  The  long  command 

rpmint  <layers> 

will  paint  the  area  of  the  box  with  the  layers  given  by  <layeTs>.  The  parameter  <  layers  >  is  a 
string  of  one  or  more  single-letter  mask  layer  abbreviations  (see  Table  1).  The  legal  mask  layers 
depend  on  what  technology  you  are  using.  Only  mask  layers  are  valid  for  the  rpaiat  command: 
the  usage  of  the  other  layers  will  be  explained  in  later  sections. 

Besides  using  the  blue  puck  button,  there  are  two  additional  ways  to  erase  paint.  The  long 
command 

mrnacpalnt  <lnynrB> 

will  erase  <layers>  from  the  area  of  the  box.  <layeis>  defaults  to  “vr".  Alternatively,  you 
can  use  the  short  command  d.  This  command  will  check  the  area  underneath  the  crosshair  to 
determine  which  layers  are  visible  at  that  point,  and  will  delete  paint  in  those  layers  from  the 
area  of  the  box.  If  there  are  no  layers  visible  underneath  the  crosshair,  then  the  d  command  will 
erase  the  layers 


1  Mask  Layers  for  Technology  “nmos"  | 

p  or  r  - 

Polysilicon  layer  (red). 

d  or  g  - 

Diffusion  layer  (green). 

m  • 

Metal  layer  (blue). 

1  or  y  - 

Implant  layer  (yellow). 

b- 

Buried  contact  layer  (brown). 

e  - 

Contact  cut  layer  (black  cross)- 

o  - 

Overglass  hole  layer  (grey). 

n  • 

Error  layer:  used  by  design  rule 

checkers  and  other  programs. 

•  . 

All  mask  layers. 

1  Mask  Layers  for  Technology  “cmos-pw  ’  | 

p  or  r  - 

Polysilicon  layer  (red). 

d  or  g- 

Diffusion  layer  (green). 

ID  or  b  • 

Metal  layer  (blue). 

P  or  y  - 

P+  implant  layer  (yellow). 

w  - 

P-well  layer  (brown). 

e  - 

Contact  cut  layer  (black  cross). 

o  - 

Overglass  hole  layer  (grey). 

n  - 

Error  layer:  used  by  design  rule 

checkers  and  other  programs. 

«  • 

All  mask  layers. 

Layers 

.\vailable  in  ail  Technologies 

1- 

Label  layer. 

S- 

Subcell  layer. 

X- 

Box  layer. 

G- 

Grid  layer. 

B- 

Background  layer. 

Tnbln  1.  The  single-letter  layer  mnemonics. 

When  specifying  layers  for  long  commands  such  as  ipaint  and  terasepalni,  the  characters 
'-h'  and  may  appear  in  the  string  as  a  convenience  in  typing.  The  character  causes 
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subsequent  layers  to  be  omitted  from  the  group  rather  than  added,  and  '+  '  cancels  the  effect  of 
an  earlier  Thus  the  layer  specification  '•-p'  is  synonymous  with  'dmibcoe'.  If  '+  '  or  is  the 
first  character  of  the  string,  then  “•I”  are  automatically  included  and  subsequent  letters  add  to  or 
subtract  from  these  layers.  For  example,  :erM*  'in  will  erase  labels  and  all  mask  layers  except 
metal. 

Caesar  maintains  a  special  collection  of  paint  called  the  yank  bufftr  that  is  used  for  shuffling 
around  portions  of  the  cell  being  designed.  To  enter  information  into  the  yank  buffer,  type  the 
long  command 

qrank 

This  command  will  treat  the  box  like  a  cookie  cutter  and  will  make  an  imprint  of  all  the  mask 
and  label  information  underneath  the  box.  The  information  is  saved  in  the  yank  buffer,  while 
leaving  the  original  circuit  unmodified.  If  <layers>  is  specified,  then  only  those  layers  are 
yanked.  The  mask  layers,  as  well  as  T  and  'S',  are  valid  for  rynnk  (later  sections  desci  ibe  how 
to  yank  labels  and  subcells).  The  long  command 

<Inyera> 

causes  all  the  information  in  the  yank  buffer  to  be  added  back  into  the  cell,  such  ihat  the  lower- 
left  corner  of  the  information  is  coincident  with  the  lower-left  corner  of  the  box.  After  :put  the 
yank  buffer  is  still  intact  and  may  be  tput  again  and  again.  <layers>  has  the  same  format  as  in 
the  wrnMpnlnt  command.  On^r  the  l^era  selected  by  <layers>  are  put;  <layers>  defaults 
to  “•IS".  The  yank  buffer  is  loaded  automatically  as  part  of  every  iernnepalnt  command.  To 
move  a  rectangular  piece  of  the  picture  just  torsM  it,  msv«  the  box  over  to  the  new  location,  and 
tput  it  back  again. 

There  are  also  short  commands  to  perform  the  same  functions  as  lynnk  and  tput.  The 
short  command  n  is  equivalent  to  lynnk  and  •  is  equivalent  to  tput  (think  of  "s'*  as  an  abbrevi»> 
tion  for  the  verb  “<tu^').  For  each  of  these  two  commands,  the  crosshair  selects  the  layors  to  be 
yanked  or  put.  If  there  is  no  visible  paint  underneath  the  crosshair,  then  layers  "*1"  are  affected 
in  n  and  “•IS"  are  affected  in  s.  If  there  is  paint  visible  underneath  the  crosshair,  then  only  the 
mask  layers  visible  underneath  the  crosshair  are  used  in  the  command. 

The  information  in  the  yank  buffer  can  be  flipped  and  rotated.  To  Bip  the  contents  upside 
down  (i.e.  mirror  about  a  horizontal  line)  use  the  long  command 

luptidedown  y 

The  y  indicates  that  the  yank  buffer  is  to  be  flipped,  rather  than  a  cell.  The  long  command 

aldewsys  y 

will  flip  the  yank  buffer  contents  sideways  (i.e.  about  a  vertical  line),  and  the  command 

iclockwine  <  degrees  >  y 

will  rotate  the  yank  buffer  contents  by  <degrees>,  which  must  be  a  multiple  of  90.  If 
<degrees>  is  omitted  then  it  defaults  to  90. 

The  long  command 

iflU  <direetloQ>  <lnyers> 

makes  it  relatively  easy  to  stretch  cells  or  extend  busses.  The  <direction>  parameter  is  one  of 
the  keywords  “up”,  “down”,  "left",  or  “right"  (unique  abbreviations  such  as  "u”  or  “1"  are 
acceptable).  <layers>  has  the  same  format  as  in  mrnsepnint;  any  of  the  mask  layers  are  valid. 
If  the  layers  are  omitted  then  all  mask  layers  are  used.  This  command  finds  all  paint  crossing  one 
edge  of  the  box  and  extends  that  paint  to  the  other  edge  of  the  box.  For  example,  rflU  up  will 
extend  all  paint  crossing  the  bottom  of  the  box  so  that  the  paint  reaches  to  the  top  of  the  box. 
Its  effect  is  just  as  if  the  colors  underneath  the  bottom  edge  of  the  box  were  a  paintbrush;  the 
brush  is  dragged  up  to  the  top  of  the  box  leaving  a  trail  of  paint  behind  it.  Try  this  command  on 
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pieces  of  the  shift  register  cell.  To  stretch  the  cell  in  the  middle,  delete  one  half  of  it  (which  puts 
the  deleted  paint  into  the  yank  buffer),  then  tput  it  back,  leaving  a  gap  between  the  two  halves 
of  the  ceil;  use  :flU  to  fill  in  the  gap. 


e.  Vlnwing  Commands 

This  section  describes  Caesar  commands  that  change  what  is  displayed  on  the  graphics 
screen.  The  commands  in  this  section  don't  have  any  effect  on  the  actual  circuit  being  designed. 
The  information  visible  on  the  graphics  display  is  called  the  current  view.  Its  location  and  size 
are  given  in  the  upper  portion  of  the  text  display  in  units  in  the  same  manner  as  the  box  location 
and  size. 

The  s  short  command  is  used  to  zoom  in  on  a  small  piece  of  the  circuit.  To  use  this  com* 
mand.  first  position  the  box  over  the  area  you  want  to  fill  the  screen.  After  typing  s,  the  view 
will  be  magnified  so  that  the  area  under  the  box  just  barely  fits  on  the  screen.  The  short  com¬ 
mand  Z  does  the  opposite  of  a:  it  demagnifies  the  view  such  that  what  used  to  fill  the  screen  just 
fits  in  the  screen  area  given  by  the  box.  The  v  short  command  changes  the  view  so  that  the 
whole  chip  just  barely  fits  on  the  screen. 

To  shift  the  current  view  without  changing  its  scale  factor,  use  the  long  command 
meroU  <dlruetlon>  <*mottiit>  <unlts> 

In  this  command,  <direction>  is  one  of  “left”,  “right”,  “up",  or  “down,”  <amount>  is  a 
number,  and  <units>  is  one  of  “lambda”  or  “screens”  (abbrevations  are  ok).  The  tseroU  com¬ 
mand  shifts  the  view  in  the  indicated  direction  by  the  indicated  amount.  The  <units>  parame¬ 
ter  defaults  to  screens,  and  if  both  <amount>  and  <units>  are  defaulted,  the  default  is  0.5 
screen. 

There  are  two  additional  short  commands  for  shifting  the  current  view.  If  5  is  typed,  the 
view  shifts  so  that  the  lower-left  corner  of  the  box  is  in  the  center  of  the  screen.  If  0  is  typed,  the 
view  shifts  so  that  the  upper-right  corner  of  the  box  is  in  the  center  of  the  screen.  In  both  cases, 
the  resulting  view  has  the  same  scale  as  the  initial  view. 

(The  rvlnw  long  command  also  changes  the  view;  it  is  discussed  in  Section  13.) 

It  is  possible  to  prevent  some  of  the  mask  layers  from  being  displayed,  thereby  making  it 
easier  to  see  the  remaining  layers.  The  long  command 

ivlnlblulayun  <!a3rurn> 

causes  only  <layers>  to  be  displayed  on  the  graphics  screen.  The  nrlslblelnyura  command 
makes  it  easier  to  verify  the  alignments  between  a  few  layers  by  eliminating  the  extraneous  layers 
from  view.  <layers>  has  the  same  format  as  in  the  wrnsn  command.  For  example,  rvin  -p 
will  remove  polysilicon  from  the  set  of  layers  that  is  displayed  and  won't  affect  any  of  the  other 
layers.  The  visible  layers  are  listed  at  the  top  of  the  text  screen.  Although  it  is  possible  to 
modify  layers  that  aren't  visible,  Caesar  will  always  issue  a  warning  if  there  is  a  chance  that 
invisible  things  may  have  been  changed;  u  may  be  used  to  undo  these  effects  if  they  weren't 
wanted. 


7.  Lnbnln 

A  label  consists  of  a  rectangle  and  a  piece  of  text.  Caesar  treats  labels  as  comments  but 
outputs  them  in  CIF  files  so  that  other  programs,  such  as  circuit  extractors,  can  use  them.  To 
place  a  label,  type  the  long  command 

:label  <text>  <posltion> 

A  rectangle  will  be  displayed  on  the  graphics  screen  with  the  size  and  location  of  the  box.  and 
<text>  will  be  displayed  near  the  rectangle  (if  the  rectangle  has  zero  height  or  width  then  a  line 
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will  appear,  and  it  both  dimensions  are  zero  then  a  small  cross  will  appear).  <position>  deter¬ 
mines  where  the  text  is  to  be  displayed:  it  must  be  one  of  the  words  “center",  “right",  ““bot¬ 
tom",  “left",  or  “top”.  If  not  specifi^,  <position>  defaults  to  “top". 

For  most  purposes  labels  are  considered  just  like  a  mask  layer,  with  layer  abbreviation  1.  A 
cell's  labels  are  displayed  only  if  the  cell  is  expanded.  Labels  are  made  visible  and  invisible  using 
the  rvialblcUyern  command.  Caesar  will  automatically  turn  off  label  vbibility  when  the  picture 
gets  so  large  that  labels  are  likely  to  clutter  things  up,  but  this  decision  can  be  overridden  using 
rvlsiblnlayers.  The  :«rnm,  qrnnk,  and  :put  commands  can  be  used  on  labels  just  like  any  of 
the  mask  layers.  The  only  difference  between  labels  and  paint  is  that  if  any  of  a  label  is  affected, 
then  the  whole  label  is  affected:  it  is  not  possible  to  erase  or  yank  half  of  a  label.  When  yanking 
or  erasing,  labels  are  ignored  if  they  completely  contain  the  box;  to  be  yanked  or  erased,  part  of 
the  rectangle  of  a  label  must  be  touching  or  contained  in  the  box. 


8.  Grid  Commnndn 

The  f  command  turns  a  grid  on  and  off  in  toggle  fashion.  By  default  the  grid  is  spaced  on 
one  unit  centers.  If  the  default  grid  spacing  does  not  suit  your  fancy,  Caesar  allows  you  to  .use 
any  spacing  you  wish.  When  you  issue  the  command 

rgrldspnelng 

Caesar  will  recompute  the  grid  so  that  the  grid  lines  have  the  same  x  and  y  spacings  as  the  x  and 
y  dimensions  of  the  box  and  the  box  faUs  exacUy  on  grid  lines.  This  new  grid  spacing  will  be 
remembered  across  g  commands  until  another  rgridspnelng  command  is  typed.  Note  iha:  the 
grid  spacing  and  box  alignment  are  independent. 


8.  Basle  Cell  Commands 

The  painting  facilities  described  above  allow  yon  to  paint  pictures  (celb)  on  the  various 
mask  layers.  The  cell  commands  described  in  this  section  allow  you  to  save  designs  on  disk  isd 
retrieve  them  later  for  further  edits.  These  commands  also  permit  to  you  to  compose  ceils 
hierarchically  into  larger  systems. 

A  cell  is  just  a  piece  of  the  design  that  can  be  stored  and  retrieved  by  name.  A  separate 
disk  file  is  used  to  hold  the  contents  of  each  cell.  At  any  given  time  in  Caesar  you  are  editing  one 
cell:  it  is  called  the  edit  cell.  The  name  (if  any)  and  bounding  box  for  the  edit  cell  are  duplayed 
in  the  upper  portion  of  the  text  screen.  The  bounding  box  is  specified  in  terms  of  the  x-  and  y- 
coordinates  of  its  lower  left  comer  and  its  x-  and  y-dimensions,  in  the  same  way  as  the  box  and 
current  view. 

To  save  the  cell  being  edited,  type  the  long  command 

msvnedl  <nnmu> 

This  will  change  the  name  of  the  edit  cell  to  <name>  and  write  it  out  on  disk  in  a  file  named 
<name>.cs.  If  <name>  isn't  specified,  then  the  cell  will  be  written  to  the  file  from  which  it 
was  originally  read.  NOTEs  Camar  dona  not  ha“vn  any  auto-aavn  or  checkpoint  faciUtlea. 
It  In  prudent  to  nave  eelln  periodically  during  long  edits  to  safeguard  against  system 

crashes. 

To  edit  a  different  cell  without  restarting  Caesar,  the  command 

Mdltcell  <name> 

should  be  typed.  This  command  destroys  all  the  information  related  to  the  current  cell  and  reini¬ 
tializes  the  system  to  edit  cell  <name>.  It  will  expect  to  find  a  file  named  <aame>.ca  contain¬ 
ing  the  description  of  the  cell.  If  the  current  cell  has  been  modified  since  the  last  time  it  was 
written,  Caesar  will  warn  yon  and  ask  yon  if  you  wish  to  continue  anyway.  If  you  type  'yes'  then 
the  changed  version  of  the  cell  will  be  lost.  If  you  type  'no'  or  carriage  return,  then  Caesar  will 
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give  you  a  chance  to  save  anything  that  has  changed  (see  the  mrltenll  command  in  Section  12 
for  details). 

To  include  an  existing  cell  as  a  subcell  of  a  new  cell,  edit  the  new  cell  and  type  the  com¬ 
mand 

rgatcall  <iiniiM> 

Caesar  will  look  on  disk  for  a  file  named  <name>.ea  and  will  make  that  file  a  subcell  of  the  edit 
ceil.  The  paint  of  the  subcell  will  appear  on  the  graphics  screen,  and  the  subcell  will  be  posi¬ 
tioned  such  that  the  lower-left  comer  of  its  bounding  box  coincides  with  the  lower-left  comer  of 
the  box.  The  tgcienll  command  causes  the  ceil  which  is  gotten  to  become  the  current  cell.  Its 
name  and  bounding  box  will  then  appear  in  the  upper  portion  of  the  text  screen.  Most  of  the  fol¬ 
lowing  commands  operate  on  the  current  cell. 

When  a  cell  contains  subcelb,  the  subcells  may  appear  in  either  of  two  ways.  Most  often, 
subcells  will  appear  in  bounding  box,  or  unexponded,  form,  in  which  case  the  subcell  is  displayed  as 
a  dark  rectangle  just  large  enough  to  contain  all  the  components  of  the  subcell.  The  mask  designs 
painted  as  part  of  the  subcell  will  not  be  shown,  nor  will  the  child’s  subceils,  but  the  cell’s  name 
will  be  dbplayed  in  the  upper  half  of  its  bounding  box.  The  second  form  for  subcells  is  expended 
form.  In  expanded  form,  the  bounding  box  of  the  subcell  is  not  displayed.  Instead,  all  of  the  cell’s 
components  (paint  and  expanded  or  nnexpanded  subsnbcells)  are  shown.  To  modify  the  display 
mode  of  the  current  cell  so  that  only  its  bounding  box  and  name  are  dbplayed,  type  the  short 
command  e.  To  expand  the  cell  again,  type  C. 

When  one  cell  b  included  in  another  using  the  igntcell  command,  Caesar  does  not  copy 
information;  it  just  stores  in  the  parent  a  pointer  to  the  child  cell’s  file.  If  the  child  cell  b  edited, 
the  new  contents  will  appear  in  the  parent  cell  the  next  time  the  parent  b  edited.  Each  parent 
cell  maintains  a  gutto  about  the  bounding  box  for  its  children  so  that  the  definitions  of  the  chil¬ 
dren  need  not  be  read  in  until  they  are  expanded  (this  speeds  up  the  editing  of  large  designs). 
However,  if  the  child  has  been  changed  then  the  bounding  box  as  displayed  in  the  parent  may  be 
incorrect.  The  guess  will  be  corrected  the  next  time  the  child  cell  b  expanded. 

To  change  the  current  cell,  position  the  crosshair  inside  the  cell  yon  wbh  to  select,  then 
push  the  top  (yellow)  button  on  the  puck.  Of  all  the  cells  that  contain  the  crosshair,  Caesw  will 
select  the  one  whose  lower-left  corner  b  closest  to  the  crosshab.  If  a  child  cell  has  the  same 
lower-left  corner  as  its  parent  then  the  child’s  comer  b  consdered  to  be  slightly  inxide  the  comer 
of  the  parent.  If  two  unrelated  celb  have  the  same  corner,  the  choice  between  them  will  be  made 
randomly.  It  is  not  possible  to  “find”  the  edit  cell.  Once  a  cell  has  been  found,  information  for 
the  new  current  cell  will  appear  in  the  text  dbplay  and  the  box  will  be  changed  to  coincide  with 
the  boviding  box  for  the  selected  cell.  To  select  the  parent  of  the  current  cell,  press  the  yellow 
button  again  without  moving  the  crosshab.  Thb  may  be  repeated  many  times  to  step  up  through 
the  cell  hierarchy. 

To  reposition  the  current  cell,  type  the  long  command 

imoruecU  <kn]rword> 

where  <keyword>  is  one  of  “byposition”,  or  “bysue”.  If  <keyword>  is  "byposition”  or  is 
omitted,  then  the  cell  is  moved  so  that  its  lower-left  comer  coincides  with  the  lower-left  corner  of 
the  box.  If  <  keyword  >  is  “bysize’’  then  the  cell  b  displaced  by  the  x-  and  y-dimensions  of  the 
box.  Thus,  what  used  to  be  at  the  lower-left  (fixed)  comer  of  the  box  will  now  be  at  the  upper- 
right  (variable)  corner.  This  is  especially  useful  for  making  fine  adjustments  on  a  large  cell  whose 
lower-left  comer  bn’t  on  the  screen. 

The 


teopyenll 

command  makes  a  copy  of  the  current  cell  and  positions  it  at  the  lower  left  corner  of  the  box  (as 
explained  above  for  the  igotenll  command,  only  a  pointer  to  the  subcell’s  file  b  copied).  The 
copy  is  made  the  current  cell.  The 
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:up«ldedowB 

command  will  flip  the  current  cell  upside  down  by  mirroring  its  contents  about  a  horizontal  line. 
The 


mldew»yn 

command  flips  the  current  cell  sideways  by  mirroring  its  contents  about  a  vertical  line.  The 

teloekwiM  <dngreM> 

long  command  will  rotate  the  current  cell  clockwise  by  the  nearest  multiple  of  90  degrees  less 
than  or  equal  to  <degrees>.  If  <degrees>  isn’t  specified,  then  the  cell  is  rotated  90  degrees 
clockwise.  Any  of  the  nipaldedown,  aidnwnyn,  or  mloekwisn  commands  may  be  followed  by  a 
“y":  this  causes  the  action  to  be  performed  on  the  yank  buffer  rather  than  the  current  cell.  The 
long  command 

idnIntacnU 


will  lelete  the  current  cell  (i.e.  it  removes  the  use  of  that  cell  from  the  edit  ceil;  it  does  not  affect 
the  disk  file  containing  the  cell). 

It's  important  to  remember  that  at  any  one  time  you  are  editing  one  and  only  one  cell.  The 
thin];s  that  you  can  change  are  the  edit  cell’s  paint,  and  the  ways  in  which  subcells  are  used  in 
the  «  dit  cell.  Yon  are  not  permitted  to  make  any  modifications  to  the  contents  of  subcells.  Thus, 
you  :annot  erase  paint  in  children,  nor  can  you  move  a  grandchild  cell  inside  a  child  cell. 


10.  Culls  and  Painting 

There  are  several  commands  that  manipulate  both  subcelb  and  paint,  or  turn  one  into  the 
othe  '.  For  purposes  of  the  Mrasu,  lyank,  and  tpui  commands,  subcells  may  be  thought  of  as  a 
lay«  (abbreviation  ’S’)  just  like  the  mask  layers  or  labels.  For  example,  ttrasa  S  will  delete  all 
subcills  that  intersect  the  box,  and  grank  -fS  will  yank  all  the  visible  layers  and  subcells  too. 
Subcelb  are  never  included  in  mrasu,  tyank,  and  iput  unless  you  specify  them  explicitly.  Furth- 
ermcre,  tyank  treats  expanded  and  unexpanded  subcells  differently.  In  lyank  S,  only  unex* 
panded  subcells  will  be  yanked.  If  a  cell  is  expanded  then  Caesar  assumes  yon  want  to  yank  the 
pain',  of  the  subcell,  rather  than  the  subcell  itself.  In  mraau,  subcelb  are  deleted  whether  or  not 
they  are  expanded.  Thu  dbtinction  b  a  bit  confunng  but  seems  to  do  the  right  things  in  prac¬ 
tice. 

As  mentioned  above,  grank  will  grab  all  paint  underneath  the  box,  regardless  of  which  cells 
contiiin  the  paint.  Thus  you  can  turn  a  subcell  into  paint  by  yanking  its  contents,  deleting  the 
subcell,  and  putting  the  paint  back  again.  As  a  convenience,  Caesar  provides  the  long  command 

lyenU  <aaniu> 

which  does  just  that.  If  <aame>  isn’t  specified,  this  command  performs  exactly  the  sequence  of 
operations  luted  above:  it  sets  the  box  to  the  bounding  box  of  the  current  cell,  expands  the  cell 
if  it  isn’t  already  expanded,  yanks  all  the  paint  and  labeb  of  the  cell,  deletes  the  cell,  and  puts 
the  paint  and  labeb  back  into  the  edit  cell.  If  <name>  u  specified,  then  the  indicated  cell  is 
first  read  from  duk  and  positioned  at  the  box,  just  as  if  tgut  <nanao>  bad  been  typed.  Since  it 
collapses  the  cell  hierarchy,  I  don’t  recommend  using  lyeull  except  for  very  small  things  such  as 
contacts  or  transntors. 

Caesar  also  provides  a  command  to  turn  paint  into  a  cell.  The  command 

rysavu  <naffla>. 

causes  all  of  the  information  in  the  yank  buffer,  including  paint,  labeb,  and  subcelb,  to  be  written 
to  disk  as  a  cell  named  <aame>.ca. 
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11.  Arraya 

Arrays  provide  an  efficient  mechanism  for  specifying  and  manipulating  groups  of  identical 
cells.  The  long,  command 

larray  <zaiM>  <yilM> 

will  turn  the  current  cell  an  array  of  cells.  The  array  will  be  a  rectangular  one  containing 
<xsiie>  instances  in  the  x-direction  and  <y8ize>  instances  in  the  y-direction.  The  instances 
will  be  spaced  in  x  and  y  according  to  the  x*  and  y*dimensions  of  the  box  at  the  time  the  (nrrsor 
command  is  issued.  Once  an  array  has  been  created,  any  manipulation  of  any  element  in  the 
array  will  affect  the  entire  array.  For  example,  if  one  element  is  expanded,  then  all  elements  are 
expanded.  Similarly,  the  entire  array  must  be  moved,  unexpanded,  and  copied  as  a  whole.  The 
mrrny  command  may  be  typed  when  the  current  cell  is  an  element  of  an  array.  When  this  hap> 
pens  the  current  array  is  replaced  by  a  new  array  such  that  the  lower-left  corners  of  the  old  and 
new  arrays  coincide. 


12.  Subedits 

When  designing  a  large  circuit  with  many  subeeils,  subcells  often  must  be  changed  in  ways 
that  depends  on  their  usage  in  the  chip  as  a  whole  (for  example,  a  subcell  might  have  to  be 
modified  to  connect  properly  to  its  neighbors).  To  facilitate  making  such  changes,  Caesar  pn^ 
vides  a  subedit  facility  that  allows  cells  to  be  edited  in  contezt.  The  long  command 

taubndlt 

causes  a  subedit  to  be  entered  by  making  the  current  cell  the  edit  ceil.  During  a  subedit,  the 
child  cell  is  displayed  just  as  it  appears  in  the  larger  cell  (e.g.  rotated  or  as  an  array),  and  all  of 
the  paint  and  other  children  of  the  larger  cell  continue  to  be  displayed  on  the  screen.  During  a 
subedit,  as  always,  only  the  edit  cell  may  be  modified.  It  is  impossible  to  select  any  information 
except  that  in  the  edit  cell  and  the  tree  of  subeeils  that  it  heads.  To  return  from  a  subedit,  type 
the  long  command 

iruturn 

Subedits  may  be  netited.  The  term  root  cell  refers  to  the  topmost  cell  in  the  cell  hierarchy,  which 
diffen  from  the  edit  cell  if  a  subedit  is  in  progress. 

During  a  subedit  the  bounding  box  of  the  edit  cell  may  change,  and  Caesar  will  automati- 
caily  propagate  this  change  to  all  uses  of  that  cell,  continuing  up  through  the  cell  hierarchy  until 
all  bounding  boxes  are  correct.  This  may  mean  that  many  cells  need  to  be  written  to  disk  in 
order  to  reflect  the  changes.  The  long  command 

rurrltnall 

will  scan  the  database  for  all  files  that  have  changed  since  the  last  time  they  were  written.  For 
each  cell  that  has  changed,  you  are  asked  for  one  of  three  responses:  “write”  to  write  the  cell  to 
disk;  “skip”  to  go  on  without  writing  this  cell;  or  “abort”  to  return  to  command  mode  immedi¬ 
ately.  The  mrltnaJl  command  is  invoked  automatically  as  part  of  several  other  commands  such 
as  s^tculL 


13.  Marks  and  tha  Box  Staek 

The  box  gets  used  for  many  different  functions,  some  of  which  conflict  with  each  other.  For 
example,  if  a  long  rectangle  is  to  be  painted  to  connect  distant  points,  the  most  convenient  way 
to  do  this  is  a)  set  the  view  to  the  area  where  the  left  end  of  the  rectangle  will  be,  and  put  the 
box's  lower-left  comer  at  the  starting  point  for  the  rectangle;  b)  move  the  view  to  where  the  other 
end  of  the  rectangle  will  be;  e)  set  the  box's  upper-right  corner  and  paint  the  rectangle.  Unfor¬ 
tunately,  it  may  be  necessary  to  use  the  box  to  change  the  view;  thus  the  position  of  the  lower- 
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left  corner  of  the  rectangle  will  be  lost.  Marks  and  the  box  stack  are  intended  to  facilitate  such 
things  as  the  drawing  of  long  connections. 

Caesar  allows  up  to  26  user-settable  marks  to  be  stored  during  an  editing  session.  Each 
mark  is  just  a  rectangle.  To  store  a  mark,  type  the  command 

imark  <markl>  <mnrkS> 

<markl>  must  be  a  single  lower-case  letter.  The  box  will  be  stored  in  the  indicated  mark.  If 
<mark2>  is  specified,  then  after  setting  <markl>  the  box  is  set  to  the  rectangle  that  is  in 
<mark2>.  If  <mark2>  isn’t  specified,  then  the  box  isn't  changed. 

When  retrieving  a  mark,  either  in  the  :mnrk  command  or  any  of  the  additional  commands 
discussed  below,  either  a  lower-case  letter  may  be  typed  to  specify  a  user  mark,  or  one  of  several 
upper-case  letters  may  be  typed  to  specify  a  system  mark.  System  marks  are  defined  in  Table  2. 
Instead  of  a  single  letter,  it  is  also  permissible  to  type  either  two  or  four  integers,  separated  by 
spaces.  This  is  referred  to  as  an  absaiite  mark.  The  first  two  integers  specify  the  x-  and  y- 
coordinates  of  the  lower-left  corner  of  a  rectangle,  and  the  second  two  integers  specify  the  x«  and 
y-sizes.  If  the  last  two  integers  aren't  sfHicified  then  the  rectangle  is  assumed  to  have  zero  size. 


C  •  *  The  bounding  box  of  the  current  cell. 

B  -  The  bounding  box  of  the  edit  cell. 

R  •  The  bounding  box  of  the  root  cell. 

V-  The  current  view. 

P  -  The  privious  view. _ 


Tablo  S.  The  system  marks. 


Although  at  any  given  time  only  cne  box  is  visible,  Caesar  maintains  internally  a  stack  of 
boxes.  The  current  box  is  at  the  top  ol  this  stack.  To  save  the  current  box  on  the  stack,  issue 
the  Icng  command 

rpiuhbox  <inark> 

This  command  saves  the  current  box  on  the  stack,  and  provides  a  new  one  to  be  manipulated.  If 
<mark>  is  present,  it  is  a  mark  that  is  made  the  new  box,  and  may  be  a  user  mark,  qrstem 
mark,  or  absolute  mark.  If  <mark>  isn’t  specified  then  the  new  box  b  made  the  same  as  the  old 
one. 

The  command 


rpopbex 

retrieves  the  last  box  pushed  onto  the  stack  by  discarding  the  current  box  and  making  the  one 
underneath  it  on  the  box  stack  the  current  box.  If  the  command  b  typed  as 

tpopbox  <  mark  > 

Then  the  current  box  is  discarded  and  a  new  current  box,  indicated  by  the  given  mark,  replaces  it 
at  the  top  of  the  box  stack. 

Marks  may  be  used  in  the  long  command 

ivinw  <mark> 

Thb  command  will  set  the  current  view  to  contain  the  area  indicated  by  <mark>.  <mark> 
may  be  a  user  mark,  system  mark,  or  absolute  mark,  and  defaults  to  “R”. 
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14.  Sesrehing 

To  assist  you  in  finding  a  label  or  subcell  of  a  given  name,  Caesar  provides  the  long  com¬ 
mand 

anarch  <rngnxp> 

where  <  regexp  >  is  a  regular  expression  in  the  same  form  as  those  suitable  for  ed  (see  the  manual 
entry  for  ed  (1)  for  details).  The  anarch  command  clears  the  box  stack,  then  Kans  all  of  the 
information  in  the  database  that  lies  underneath  the  box  (in  subedits  only  information  in  the  suly 
tree  of  the  edit  ceil  is  examined).  For  each  label  that  matches  < regexp >  the  label's  box  is 
pushed  onto  the  top  of  the  box  stack  and  a  message  is  output  on  the  terminal.  Similarly,  for  each 
cell  whose  name  matches  <regexp>  the  cell’s  bounding  box  is  pushed  onto  the  box  stack  and  a 
message  is  output.  After  the  command  has  finished,  the  various  matches  can  be  found  merely  by 
popping  them  from  the  box  stack.  For  example,  taearch  the  will  find  all  labels  and  cells  that 
intersect  the  box  and  contain  the  string  “the". 


15.  FUenamen  and  Patha 

In  order  to  make  it  easy  to  identify  how  files  are  to  be  used,  and  in  order  to  prevent 
accidental  misuse  of  files,  Caesar  uses  a  standard  set  of  file  name  extensions.  For  example,  it 
expecu  all  files  that  are  edited  using  Caesar  to  have  lamcs  ending  in  the  characters  “.ca".  By 
convention,  all  colormap  files  use  a  monitor  type  as  extension,  and  all  CIF  files  have  the  extension 
“.cir*.  Caesar  doesn't  absolutely  require  you  to  abide  by  these  conventions,  but  it  makes  it  easy 
for  yon  to  do  so  and  difficult  for  you  to  do  otherwise.  For  example,  in  the  tgetenll  command, 
Caesar  will  first  try  to  get  the  ceil  by  appending  “.ca”  to  the  name  you  type.  If  this  fails,  then  it 
will  try  the  unextended  name.  Similar  things  happen  for  colormap  and  CIF  files;  Caesar  will  first 
append  the  standard  extension  and  will  only  try  the  unextended  name  if  the  extended  one  doesn’t 
work. 

There  is  one  way  to  get  around  the  default  uxtecsions.  If  a  name  that  you  supply  contains 
a  character,  then  Caesar  will  assume  that  you  have  your  own  (eraty)  scheme  for  name  exten¬ 
sions  and  will  not  tack  on  any  of  its  own. 

Caesar  also  implements  a  search  path  mechanism  that  makes  it  easier  to  work  on  large 
designs  where  the  component  files  are  spread  over  man;'  directories.  The  search  path  contains  the 
names  of  one  or  more  directories  that  Caesar  wiU  examine  in  order  when  opening  files  for  reading. 
Whenever  Caesar  attempts  to  open  a  file  for  reading,  it  searches  for  the  file  in  each  of  the  direc¬ 
tories  in  the  path  until  the  open  succeeds.  If  no  directory  in  the  path  contains  the  file,  Caesar 
will  make  one  last  attempt  by  looking  in  a  system  library  directory.  On  the  VAX'es  at  Berkeley, 
the  library  area  is  *ead/caesar/lib.  The  library  directory  contains  standard  technology  and  cotor 
map  files,  shiftcell,  and  other  files.  If  the  original  file  name  begins  with  a  or  “/"  then  the 
path  mechanism  isn't  used. 

The  initial  search  path  is  set  to  (the  working  directory)  when  Caesar  begins  execution, 
unless  overridden  by  the  -p  switch  or  a  .eaeaar  file.  To  change  the  path  once  Caesar  is  running, 
^pe  the  long  command 

ipntli  <atr!ng> 

where  <string>  contains  one  or  more  directory  names  separated  by  blanks  or  colons.  From  then 
on,  Caesar  will  search  for  files  by  looking  in  each  of  the  directories  in  string  in  the  order  of  their 
appearance  in  <string>.  Directories  may  be  specified  using  the  notation,  and  is 
equivalent  to  Typing  ipnth  with  no  parameters  will  cause  Caesar  to  print  out  the  current 
search  path.  Paths  may  also  be  specified  when  Caesar  is  invoked  by  using  the  -p<path>  switch, 
with  <path>  having  the  same  format  aa  <striag>  above. 

The  search  path  mechanism  is  only  used  for  reading  files.  When  writing  out  files,  one  of 
two  mechanisms  is  used.  Normally,  files  are  written  into  the  current  directory  unless  the  file 
name  starts  with  '*'  or  '/'.  The  one  exception  to  this  rule  occurs  when  isavnenll  is  invoked 
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without  specifying  a  file  name.  In  this  case,  Caesar  will  write  try  to  write  the  cell  back  to  the 
place  from  which  it  read  it,  regardless  of  where  that  may  be. 


Id.  Macron 

Caesar  has  a  very  simple  facility  for  defining  macros.  A  macro  is  just  a  short  command 
defined  by  the  user,  such  that  whenever  a  particular  character  is  typed  as  a  short  command,  a 
long  command  is  executed  instead.  The  long  command 

imaero  <eliaramtcr>  <loBg  eommnnd> 

will  set  up  a  macro  such  that  <long  command>  is  executed  whenever  <cl)aracter>  is  typed. 
For  example,  the  command 

:maero  1  paint  p\;  box  up  1\;  box  left  1 

defines  a  new  short  command  1  that  will  paint  polysilicon  and  move  the  box  diagonally  up  and  to 
the  left  one  unit.  The  backslashes  are  be  used  to  prevent  the  semi-colons  from  terminating  the 
macro  definition  (without  the  backslashes,  tb:  command  would  have  defined  a  macro  that  just 
paints;  then  the  box  moving  commands  would  have  been  executed).  Macros  override  the  qrstem 
definitions  of  short  commands.  To  remove  a  particular  macro  and  restore  tho  system  definition, 
type 

:maero  <  letter  > 


To  remove  all  macro  definitions,  type 


tmeero 

Note  that  macros  may  include  short  commands  by  using  the  single-quote  notation  defined  in 
Section  3.  Thus, 

tmaero  1  *a\;  box  up  1\;  box  left  1 

is  the  same  as  the  macro  definition  in  the  ptevi.ous  paragraph  except  that  it  yanks  all  the  layers 
visible  underneath  the  crosshair.  When  short  commands  are  invoked  using  th;  single-quote  notar 
tion,  macro  expansion  is  NOT  performed.  Thus  in  the  above  example,  any  macro  definition  for 
the  short  command  a  is  ignored. 


17.  Command  Flics 
The  command 

aourec  <flla> 

will  read  <file>  and  execute  each  line  of  the  die  as  a  long  command.  If  the  last  character  of  a 
line  is  a  backslash,  then  the  backslash  is  removed  and  the  line  is  joined  to  the  following  line. 
When  Caesar  starts  up  it  attempu  to  read  two  command  files.  First,  it  looks  for  a  file  named 
.eae$ar  in  the  home  directory  of  the  user,  if  this  file  exists  then  it  is  processed  as  a  command  file. 
Then  Caesar  attempts  to  read  .csersr  in  the  current  directory.  The  startup  command  files  are 
useful  for  setting  paths,  technologies,  and  macros. 


18.  CIF  Output 

The  format  in  which  Caesar  stores  its  cells  on  disk  is  not  Caltech  Intermediate  Form,  the 
standard  representation  used  to  fabricate  chips.  However,  the  long  command 

mlf-sblpx  <Bnmn>  <seBls> 

will  cause  Caesar  to  write  out  in  CIF  format  a  file  that  describes  the  edit  cell.  The  parameters 
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and  switches  may  be  specified  in  any  order  and  are  all  optional.  <Dame>  is  the  name  of  a  file  in 
which  to  write  the  CIF  (a  .cif  extension  is  appended  automatically).  If  <name>  is  not  specified, 
then  the  name  of  the  edit  cell  is  used  by  default.  <scale>  is  a  number  that  is  used  for  conver¬ 
sion  from  Caesar  units  (lambdas)  to  CIF  units  (centimicrons);  it  specifies  how  many  centimicrons 
there  are  in  one  lambda.  If  <scale>  is  not  specified  then  it  defaults  to  200  (i.e.  lambda  a*  2 
microns). 

Warning;  if  your  design  is  made  on  a  l/2>lambda  grid,  then  round-off  errors  will  occur  in 
the  CIF  file  if  the  scale  is  not  an  even  multiple  of  4  centimicrons.  If  your  design  is  entirely  on  a 
lambda  grid,  then  round-off  errors  will  occur  if  the  scale  is  not  an  even  multiple  of  2  centimicrons. 
When  round-off  errors  occur,  pieces  of  the  design  may  appear  to  move  by  as  much  as  one  centimi- 
cton.  Although  this  movement  will  not  cause  any  noticeable  effect  during  fabrication,  it  may 
cause  CIF-based  analysis  tools  to  misinterpret  the  circuit.  To  be  safe,  always  use  a  scale  factor 
that  is  a  multiple  of  4  centimicrons,  e.g.  for  lambda  *  2.5  microns,  specify  a  scale  of  252  or  260. 

The  CIF  information  may  be  used  for  many  different  purposes:  a)  for  getting  hardcopy  plots 
of  the  circuit;  b)  for  input  to  circuit  extractors,  design  rule  checkers,  and  simulators;  and  c)  for 
fabricating  chips.  The  switches  control  what  informatkrn  is  to  be  output  into  the  CIF  file,  accord¬ 
ing  to  the  way  the  CIF  file  will  be  used.  As  many  as  four  different  kinds  of  information  may  be 
output  in  the  CIF  file: 

Silicon  What  actually  gets  fabricated:  rectangles  specifying  the  mask  layers. 

Bounding  Boxes  When  CIF  representation  is  being  used  as  a  means  for  getting  checkplots, 
Caesar  can  output  commands  that  cause  unexpanded  cells  to  be  plotted  in 
bounding  box  form.  This  is  done  by  outputting  vectors  (“OV"  user  exten¬ 
sion)  and  text  (“2”  user  extension)  so  that  a  bounding  box  will  appear 
along  with  the  cell’s  name  and  id  when  the  CIF  file  is  plotted.  This  makes 
it  possible  to  get  block  diagrams  of  circuits. 

Labeb  F^r  each  label  in  an  expanded  cell,  Caesar  will  output  vectors  and  text  to 

make  the  label  appear  in  plots  just  as  it  appears  on  the  screen  (except  that 
labels  that  appear  as  crosses  on  the  Kreen  will  appear  as  dots  in  the  plot). 
This  feature  is  only  useful  for  getting  hardcopy. 

Points  CIF  provides  the  “94”  construct  to  give  names  to  various  points  on  the 

masks.  Caesar  will  generate  “94”  commands  for  each  label.  These  com¬ 
mands  are  used  by  several  of  the  circuit  extraction  and  simulation  pro 
grams. 

If  no  switches  are  specified,  Caesar  will  output  none  of  the  above  information  except  silicon. 
Furthermore,  cells  will  implicitly  be  expanded  as  CIF  is  being  output  so  that  all  the  silicon  in  the 
edit  cell  and  its  descendants  will  appear  in  the  CIF  output.  The  -b,  -I,  and  -p  switches  will  enable 
bounding  boxes,  labels,  and  points,  respectively,  and  the  -s  switch  will  disable  silicon  output.  If 
the  -X  switch  is  specified,  then  cells  will  not  be  automatically  expanded;  silicon  will  appear  only 
for  cells  that  are  currently  expanded.  This  switch  can  be  used  in  conjunction  with  the  -b  switch 
to  get  block  diagrams.  Some  useful  combinations  of  switches  are:  a)  to  get  a  plot  of  things  just 
as  they  appear  on  the  screen,  use  self  -xbl;  to  generate  CIF  files  suitable  for  manufacturing,  use 
self)  to  get  CIF  files  for  circuit  extraction  and/or  simulation,  use  self  -p. 


19.  Noa-Interaetlve  Use  of  Cnesnr 

If  the  -n  twitch  it  present  on  the  command  line,  then  Caesar  will  execute  in  non-interactive  mode. 
In  this  snode,  it  does  not  use  a  color  display  at  ail,  nor  does  it  display  the  normal  menus  aud 
statisties  on  the  text  display.  Instead,  it  merely  reads  long  commands  from  its  standard  input 
(the  single-quote  notation  described  in  Section  3  can  be  used  to  invoke  short  commands).  This 
mode  is  useful  for  running  the  self  command  in  background,  for  example.  If  an  end-of-file  is 
encountered  on  the  standard  input  when  in  non-interactive  mode,  Caesar  exits  immediately, 
without  saving  anything. 


Editing  \'LSI  Circuits  with  Caesar 


March  22.  1063 


20.  Uentiflcrt 

This  command  is  not  well  supported,  and  hence  is  not  likely  to  be  very  useful. 

Id  additioa  to  its  aame,  which  refers  to  the  file  containing  its  definition,  each  cell  may  be 
given  an  instance  identifier,  or  ID.  The  ID  distinguishes  a  subcell  from  all  the  other  children  of  its 
parent,  particularly  those  siblings  that  share  the  same  definition  file.  Caesar  does  not  currently 
use  the  ID  information  and  does  not  output  it  to  CIF  files,  so  it  serves  only  to  document  the  cir¬ 
cuit.  At  some  future  date  additional  design  toob  may  take  advantage  of  the  ID  information.  To 
give  a  cell  an  instance  identifier,  type  the  long  command 

ddcatUyeell  <ld> 

The  identifier  will  become  the  instance  identifier  for  the  current  cell,  and  will  appear  in  the  lower 
half  of  the  cell's  bounding  box  when  the  cell  is  unexpanded.  The  same  identifier  may  not  be  used 
in  two  subcelb  of  the  same  parent. 

When  an  element  of  an  array  is  given  an  identifier,  Caesar  will  give  IDs  to  .all  the  elements 
of  the  array  by  taking  the  name  and  appending  ‘*(x,y]’*  where  x  and  y  are  '.he  indices  of  the  ele¬ 
ment  within  the  array.  Normally,  the  indices  start  from  0  at  the  lower-left  comer.  To  change 
thu,  the  array  should  be  generated  using  the  command 

tnrrny  <xl>  <xS>  <yl>  <y2> 

Thb  command  generates  an  array  with  elements  indexed  from  <xl>  to  <x2>  in  the  x- 
direction  and  from  <yl>  to  <y2>  in  the  y-direction. 


21.  Mlacellnaeoun  Commnndn 

Caesar  can  communicate  with  the  Lyra  layout  rule  checker.  To  invoke  L/ra,  first  use  the 
box  to  select  the  area  you  wish  to  check.  Then  type 

tlyra  <rttlesnt>. 

The  parameter  <nileset>  is  optional  and  is  passed  to  Lyra  with  the  -r  switch.  If  <rttli'set  >  is 
omitted,  an  appropriate  rulest  b  picked  based  on  the  current  technology.  rule  violations 

returned  by  the  layout  rule  checker  are  displayed  as  labels  in  the  edit  cell. 

The  short  command  .  (period)  causes  the  most  recent  long  command  to  be  repeated. 

The  long  command 

tqoit 

causes  Caesar  to  cease  execution  and  return  to  the  shell. 

The  long  command 

truant 

will  re-initialite  the  graphics  display.  Thb  command  is  needed  if  the  dbplay  should  become 
fouled  up  or  if  the  sleeper  job  should  die.  First  reset  the  color  dbplay.  Make  sure  that  a  sleeper 
job  b  still  logged  in,  if  necessary.  Then  invoke  the  truant  command. 

A  long  command  b  provided  whose  function  is  equivalent  to  pressing  a  puck  button.  The 
command  syntax  b 

tbuttoa  <attmbnr>  <x>  <y> 

Thb  long  command  simulates  the  pressing  of  button  <  number  >  at  the  screen  location  given  by 
<x>  and  <y>  (in  pixel  coordinates).  <aumber>  must  be  0.  1,  2,  or  3,  and  the  coordinates 
must  lie  on  the  screen.  If  <x>  and  <y>  aren’t  specified,  then  the  crosshair  position  b  used. 
Thb  command  is  useful  for  macros  and  for  dbplays  without  buttons  on  their 
puck/mouse/joystick. 
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Editing  \X£1  Circuits  with  Caesar 


Marcd  i9S3 


A  new  technology  may  be  loaded  with  the  long  command 

rteehnolofy  <flln> 

where  <file>  is  the  name  of  a  technology  file  (see  Section  22).  .K  default  “.tech"  extension  is 
supplied.  This  command  changes  Caesar's  current  technology,  regardless  of  the  technology  of  the 
cells  being  edited,  and  may  thereby  produce  bixarre  and  undesirable  effects  (for  example,  if  the 
existing  cells  are  saved  on  disk,  they  will  be  marked  with  the  new  technology).  Normally  :tceh> 
oology  should  only  be  invoked  when  the  edit  cell  is  null. 

The  short  command  *L  (control-L)  eanses  the  graphics  display  to  be  erased  and  redrawn, 
and  the  command  I  causes  both  the  text  and  graphics  displays  to  be  redrawn.  These  commands 
shouldn't  be  necessary  very  often.  Nonetheless,  one  or  the  other  of  the  screens  will  occasionally 
get  trashed,  and  this  provides  a  recovery  mechanism. 

X  is  an  “expand  all"  command.  Any  cell  that  intersects  the  box  is  expanded,  then  all  the 
sttbceils  that  intersect  the  box  are  expanded,  and  so  on  until  there  is  nothing  but  paint  left  uader> 
neath  the  box.  The  short  command  x  is  the  inverse  of  X:  ail  of  the  cells  that  intersect  the  box, 
but  do  not  completely  contain  the  box,  are  unexpanded  to  be  drawn  in  bounding  box  form. 

The  long  command 

tpoek  <Iaycrn> 

provides  another  form  of  “expand  all".  It  causes  all  the  paint  lying  underneath  the  box  to  be 
displayed,  including  paint  in  unexpanded  cells.  However,  the  expanded/unexpanded  state  of  cells 
is  not  changed,  so  the  effects  of  the  command  are  temporary:  the  next  time  the  area  is  redrawn, 
information  will  appear  as  it  did  before  the  tpcuk  command.  <layers>  has  the  same  format  as 
in  the  :eraso  command.  Only  the  layers  given  by  <layers>  are  displayed  (if  <layers>  isn't 
specified  then  all  visible  layers  are  shown)  and  only  the  area  underneath  the  box  is  affected.  The 
:pMk  command  is  somewhat  faster  than  X  and  x  since  it  doesn't  require  any  modifications  to  the 
database  and  involves  only  the  area  underneath  the  box.  Information  drawn  by  ipuok  is  not 
“officially"  visible  and  hence  is  ignored  by  commands  such  as  qrnnk  and  tflU. 

The  long  command 

ifluabecll 

simply  unloads  the  current  cell  from  main  memory  This  command  has  two  uses.  First,  if  there 
are  several  people  using  different  workstations  to  edit  different  cells  of  the  same  chip  at  the  same 
time,  diushecll  provides  a  mechanism  to  pass  back  and  forth  updated  versions.  If  one  person 
changes  a  cell  and  saves  it  on  disk,  then  the  other  person  can  see  the  latest  version  by  flushing  his 
current  version.  Thus  it  isn't  necessary  to  leave  Caesar  and  restart.  Flushing  is  also  useful  if  you 
edit  a  cell  and  then  decide  that  you  don't  want  the  edits  after  all.  rflusheuU  will  throw  away  the 
changes  and  reload  the  disk  version. 

The  long  command 

nisngu  <ftlunnmu> 

can  be  used  to  flgure  out  which  flies  in  your  directory  area  are  part  of  a  design.  The  lusngu  com* 
mand  will  write  out  in  <fllename>  a  list  of  all  flies  containing  deflnitions  that  are  part  of  the  cell 
hierarchy. 

Caesar  is  still  undergoing  development,  so  yon  may  stumble  across  bugs  and  unpleasant 
features  as  you  use  it.  Hopefully  this  won't  b^pen  loo  often,  but  when  it  does  you  can  use  the 

igripn 

command  to  give  feedback  to  whomever  is  maintaining  the  system.  When  yon  type  igrlpn  the 
mail  program  is  run  and  Caesar  will  supply  the  address  of  the  ^stem  maintainer.  Just  type  in 
your  message  as  you  would  if  yon  had  run  mail  yourself.  Please  put  the  word  “Caesar”  in  the 
subject  or  flrst  line.  Feel  free  to  suggest  enhancements  as  well  as  report  problems.  When  you 
have  typed  in  the  message,  type  *D  and  control  will  return  to  Caesar. 
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22.  Tecbnologle* 

Thit  section  is  intended  for  system  maintainers  only, 

Caesar  versions  6  and  later  are  technology  independent:  they  permit  you  to  define  new 
technologies  of  your  own  design.  For  Caesar’s  purposes,  technology  information  merely  contains 
layer  names  and  information  about  how  to  display  them.  A  technology  is  defined  in  a  technology 
file,  which  usually  has  a  “.tech”  extension.  For  example,  the  standard  NMOS  technology  is 
defined  in  a  file  called  “nmos.tech”  in  the  system  library.  To  create  a  new  technology  or  an 
extended  version  of  an  existing  technology  you  need  only  create  a  new  technology  file.  Table  3 
contains  the  Berkeley  technology  file  for  NMOS. 


nmos 

nmos 

polysilicon  pr  0  solid  1 
L  NP 

diffusion  dg  0  solid  2 
L  ND 

metal  mb  0  solid  4 
L  NM 

implant  iy  0  solid  10 
L  Nl 

cut  c  377  cross  40 
L  NC 

overglass  o  377  ll-ur  41 
L  NG 

errors  e  0  solid  42 
L  NZ 

buried_contact  x  0  stipple  20 
L  MB 

210  42  210  42  210  42  210  42 
Tnbln  3.  The  Berkeley  NMOS  technology  file. 


The  first  line  of  each  technology  file  is  the  name  of  the  technology  e.g.  “nmos”.  Every  cell 
is  also  marked  with  a  technology  name;  the  technology  names  in  the  ca  and  .tech  files  must 
agree.  Caesar  does  not  permit  celb  of  more  than  one  technology  to  be  edited  at  one  time.  The 
second  line  of  the  technology  file  contains  the  name  of  the  color  map  to  be  used  for  that  technol¬ 
ogy.  When  looking  up  the  color  map  file,  Caesar  will  supply  the  monitor  type  as  extension  (see 
Section  23  for  a  detailed  docussion  of  color  maps). 

Lines  after  the  first  two  are  grouped  in  pairs  or  triplets;  each  group  describes  one  mask 
layer.  There  may  be  up  to  16  layers.  The  order  of  the  layers  makes  no  difference.  The  first  line 
of  each  group  has  the  syntax 

<Ioncnam«>  <shortnames>  <outI!nesiyla>  <flUstyle>  <layer>. 

<Iongname>  is  a  descriptive  name  for  the  layer,  and  is  used  by  Caesar  to  identify  mask  layers  in 
cell  files.  <longname>  must  not  be  either  "labels”  or  “end”.  <shortnames>  consists  of  one  or 
more  characters  that  will  be  used  as  abbreviations  for  the  layer  in  commands  such  as  terase  and 
tyank.  <sbortnamcs>  entries  for  ail  layers  must  be  distinct,  and  must  not  repeat  any  of  the 
predefined  layer  names  (those  in  the  lower  half  of  Table  1).  <outlinestyle>  and  <fillstyle> 
describe  how  rectangles  in  the  layer  are  to  be  displayed.  Each  rectangle  is  drawn  in  two  stages; 
first  an  outline  is  drawn,  then  the  contents  of  the  rectangle  are  filled.  <otttlinestyIe>  is  an 
eight-bit  octal  number  whose  bits  give  a  pattern  indicating  bow  the  outline  is  to  be  drawn.  AU 
ones  (377)  means  draw  the  outline  as  a  solid  line,  zero  means  don't  draw  any  outline  at  all,  360 


Editing  \XSI  Circuits  with  Caesar 


March  J  J.  1983 


means  draw  a  dashed  line,  252  means  draw  a  dotted  line,  and  so  on.  <fii]style>  indicates  how 
the  box  is  to  be  filled,  and  must  be  one  of  the  keywords  listed  in  Table  4.  The  solid  style  is  the 
most  efficient  one.  <layer>  is  an  octal  layer  number,  which  will  be  explained  below.  The 
second  line  for  each  layer  contains  the  GIF  command  used  to  switch  to  that  layer.  This  informa> 
tion  is  used  when  generating  GIF  files.  If  the  <fiilstyle>  is  “stipple",  then  there  is  a  third  line  in 
the  group  (after  the  GIF  command  line)  that  contains  eight  octal  numbers  giving  an  fi-by*8  array 
of  ones  and  zeroes  used  for  stippling  that  layer.  Stippling  is  only  available  on  Ghromatics, 
AED767,  and  specially  microcoded  AED512  displays  (display  type  '*UCB512”)at  present. 


empty 

Don't  draw  anything  inside  the  rectangle. 

solid 

Fill  the  rectangle  with  solid  color. 

cross 

Draw  diagonal  lines  between  opposite  corners. 

horizontal 

Gross-hatch  with  horizontal  lines. 

vertical 

Gross-hatch  with  vertical  lines. 

U-ur 

Gross-hatch  with  lines  running  from 

lower  left  to  upper  right. 

ul-lr 

Gross-hatch  with  lines  running  from 

upper  left  to  lower  right. 

stipple 

Use  stipple  pattern  given  in  third  line. 

Tabln  4.  Fill  styles  for  technology  files. 


The  <layer>  entry  must  be  an  octal  number  that  is  either  1,  2,  4,  10,  20,  or  between  40 
and  52  inclusive.  No  two  <  layer  >  entries  may  be  the  same.  <  layer >  determines  whether  or 
not  the  corresponding  mask  layer  is  opaque  or  tranopareM.  The  distinction  between  transparent 
and  opaque  layers  is  necessary  because  the  color  displays  don't  have  enough  memory  to  allocate  a 
separate  bit  plane  for  each  mask  layer.  Transparent  layers  are  those  with  <layer>  values  0>4. 
They  have  two  nice  properties:  first,  it  is  possible  to  see  transparent  layers  even  when  they  lie 
underneath  other  transparent  layers;  second,  Gaesar  can  perform  screen  operations  on  tran> 
sparent  layers  more  efficiently  than  for  opaque  layers.  Opaque  layers  have  the  property  that  they 
blot  out  everything  underneath  them.  If  one  opaque  layer  is  colored  at  a  point,  it  is  impossible  to 
see  transparent  layers  or  other  opaque  layers  underneath  it.  Higher-numbered  opaque  layers  blot 
out  lower-numbered  opaque  layers.  Gross-hatching  was  implemented  for  use  with  opaque  layers: 
only  where  the  outline  or  crosa-hatching  is  drawn  does  other  information  get  blotted  out.  A  good 
rule  of  thumb  when  assigning  layer  numbers  is  to  make  the  densest  and  most  frequently  manipu¬ 
lated  layers  transparent. 

Gells  edited  under  one  technology  can  be  edited  under  another  technology  with  no  side 
effects  as  long  as  the  two  technologies  agree  on  the  <longDame>  values  for  each  mask  layer  and 
the  two  technology  flies  have  the  same  first  line.  However,  strange  things  may  happen  if  you 
switch  technologies  while  a  cell  is  loaded  into  Gaesar:  the  layers  of  the  old  technology  will  be 
mapped  into  those  of  the  new  technology  according  to  their  <layer>  values,  rather  than  their 
<longname>  values.  This  will  generally  NOT  produce  the  desired  effects,  although  it  can  be 
used  to  move  information  from  one  layer  to  another.  Normally,  the  cell  to  be  edited  should  be 
reloaded  (using  the  tedlteell  command)  after  a  switch  of  technology. 

S3.  Color  Maps 

Thia  oeetion  ia  intended  for  ayetem  maintainera  only. 

Golor  maps  are  tables  that  indicate  what  color  to  display  for  each  of  the  various  layers. 
Gaesar  allows  you  to  change  the  color  choices  and  to  save  your  own  color  map  files.  Each  color  is 
specified  by  means  of  red,  green,  and  blue  intensities  that  may  range  from  0  to  25S.  To  read  out 
the  current  color  values  for  a  particular  layer  or  layer  combination,  type  the  command 
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reolormap  <  layer  > 

where  <layer>  is  any  combination  of  the  layer  mnemonics  from  Table  1  (if  you  are  using  a 
different  technology  then  the  mask  layer  mnemonics  will  be  different).  For  e.xampie,  teolormap 
p  will  print  out  the  red,  green,  and  blue  intensities  for  the  color  that  is  displayed  where  polysici* 
Ion  appears  by  itself,  and  molormap  pm  will  print  out  the  intensities  for  the  color  used  to 
represent  overlaps  between  polysilicon  and  metal.  The  command 

leolormap  <Iayer>  <rad>  <grecn>  <blue> 

will  set  the  colors  for  <layer>  to  those  given.  If  the  first  character  of  <layer>  is  a  then 
the  indicated  colors  are  stored  for  aU  layer  combinations  that  contain  the  selected  layers.  For 
example,  teolormap  'X  2SS  255  255  will  cause  the  color  white  to  be  display'll  anywhere  that 
the  box  appears,  no  matter  what  other  layers  may  be  present.  The  layer  may  a.so  be  specified  as 
an  octal  number. 

There  is  a  different  color  for  each  possible  combination  of  transparent  layers.  In  existing 
color  maps,  the  colors  are  chosen  to  make  certain  layers  appear  on  top  of  other  layers.  For  exam* 
pie,  the  colormap  entry  for  “pm”  is  different  from  the  entries  for  “p”  and  for  “m  ’,  and  is 
intended  to  make  the  metal  layer  appear  on  lop  of  the  polysilicon  layer  while  still  permitting 
underlying  details  to  be  distinguished.  There  is  only  one  color  table  entry  for  e:ich  opaque  entry: 
in  NMOS,  for  example,  “cm",  “cp",  and  “•c”  all  refer  to  a  single  entry.  The  G,  S,  and  1  layers 
are  all  the  same  as  far  as  the  color  map  is  concerned;  changing  any  one  of  them  will  change  all  of 
them.  However,  the  G/S/1  layer  is  transparent  with  respect  to  the  mask  layers;  a  separate  color 
exists  for  each  combination  of  mask  layer  and  G/S/l.  The  box  layer  is  also  transparent  with 
respect  to  mask  layers  and  the  grid/subcell/labci  layer.  Layer  name  “3”  is  ised  to  select  the 
color  of  the  background.  This  layer  is  blotted  out  by  any  of  the  other  layers. 

Modified  colormaps  may  be  saved  on  disk  and  retrieved.  The  command 

reaave  <nnme> 

causes  the  current  colormap  values  to  be  saved  in  file  <Dame>.  Caesar  uses  the  monitor  type  as 
extension  to  the  name.  Thus,  if  you  are  working  on  a  monitor  of  type  “stc”,  the  command 
“:csave  cmos-pw”  will  create  a  file  named  “cmos*pw.std''.  The  command 

reload  <natiie> 

causes  Caesar  to  reload  its  colormap  from  the  named  file,  once  again  using  the  monitor  type  as 
extension. 


24.  Loentlng  the  Correct  Display 

Thia  feetion  i$  intended  for  oyetem  maintainero  only. 

When  Caesar  starts  up,  it  tries  to  figure  out  what  kind  of  display  it  should  use  by  consulting 
the  displays  file.  At  Berkeley,  the  displays  file  is  located  in  'cad/lib/displays.  Each  line  in  the 
displays  file  describes  one  workstation  and  contains  up  to  five  strings.  The  first  string  gives  the 
file  name  of  the  text  terminal  of  the  workstation.  The  second  string  gives  the  file  name  of  the 
device  to  use  for  I/O  to  and  from  the  color  display.  The  third  string  gives  the  type  of  monitor 
attached  to  the  display.  The  fourth  string  gives  the  type  of  display,  and  the  fifth  string  gives  the 
file  name  to  use  for  reading  characters  from  the  display's  tablet.  Table  5  lists  the  display  types 
understood  by  all  versions  of  Caesar.  Some  sites  may  also  have  support  for  display  types  not 
listed.  The  “display  type”  indicates  what  kind  of  electronics  is  used  to  hold  the  raster  memory, 
e.g.  “AED512”  or  “Omegal40''.  The  “monitor  type”  indicates  the  type  of  color  monitor  that  is 
attached  to  the  display.  The  monitor  type  is  used  to  select  the  right  color  map  to  use  (phosphors 
on  different  monitors  may  be  slightly  different  and  hence  require  different  color  maps).  At  Berke* 
ley  we  use  several  different  types  of  monitors  with  different  color  characteristics.  Caesar  under* 
stand  two  general  kinds  of  monitors:  "std”  and  “pale”.  The  monitor  type  is  used  by  Caesar  to 
select  a  color  map  that  will  make  your  circuits  look  nice  on  that  particular  monitor.  The  "std” 
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colormaps  work  well  with  most  monitors.  Some  monitors  with  long*persistence  phosphors  have  a 
blue  phosphor  that  is  especially  pale.  With  these  monitors  the  “pale"  colormaps  work  well.  If 
you  have  a  monitor  with  unusual  colors,  you’ll  probably  have  to  make  a  new  colormap  by  modify¬ 
ing  one  of  the  standard  maps.  If  any  of  the  strings  are  omitted,  default  values  are  used.  In  the 
case  of  the  tablet  file,  the  default  is  to  use  the  same  file  as  for  display  output. 

Values  from  the  displays  file  are  overriden  by  command  line  switches. 


Dbplay  Type 

Manufacturer 

Notes 

AED512 

UCB512 

AED767 

AED640 

0mega440 

R9400 

Vectrix 

Chr79C0 

Adv.  Electr.  Design 
Adv.  Electr.  Design 
Adv.  Electr.  Design 

Adv.  Electr.  Design 
Metheus 

Ramtek 

Vectrix 

Chromatics 

(AED512  with  UCB  microcode  for  stipples) 
(Thb  dbplay  type  can  abo  be 
used  for  some  Jupiter  dbplays) 

(AED767  configured  as  640x483  pixels) 
(Courtesy  Metheus  Corp.) 

(Courtesy  Gary  Bishop,  UNC-Chapel  Hill) 
(Courtesy  Gary  Bbhop  and  Eric  Vook, 
UNC-Chapel  HiU) 

(Courtesy  Dan  Schuh,  Univ.  Wise.) 

Tnbln  8.  Supported  display  types. 


25.  Known  Buga  and  Quirks 

1.  The  cell  exp:.nsion  facilities  have  a  quirk  stemming  from  the  fact  that  if  the  same  subcell 
is  used  in  two  places  Caesar  only  keeps  a  single  copy  of  the  definition  of  the  cell  in  order  to  save 
memory  space.  What  this  means  is  that  if  you  are  editing  a  cell  with  two  identical  child  eelb, 
each  with  a  child  of  its  own,  then  if  one  of  the  grandchildren  is  expanded  the  other  grandchild 
will  be  expanded  as  veil.  This  quirk  only  affects  grandchildren  and  more  distant  descendants  of 
the  edit  celt;  childreii  may  be  expanded  and  unexpanded  independently. 

2.  If  Caesar  should  crash,  the  text  terminal  will  be  left  in  a  weird  state.  To  escape  this 
state,  type  “reset”  followed  by  linefeed  (control-J),  NOT  carriage  return. 

3.  Caesar  expects  that  label  text  will  fall  within  the  bounding  boxes  of  the  celb  they  belong 
to.  This  results  in  much  greater  efficiency  when  moving  celb  around,  since  Caesar  only  worries 
about  the  area  inside  the  cells'  bounding  boxes.  However,  if  label  text  faJb  outside  the  bounding 
box,  it  will  not  be  properly  erased  when  the  cell  b  moved.  To  clean  up  the  xreen  it  will  be 
necessary  to  type  'L. 

i.  Caesar  handles  interrupts  (e.g.  rubout)  but  in  a  stilted  fashion.  When  the  interrupt  key  is 
typed,  all  searches  in  progress  will  be  stopped  immediately,  but  no  other  computations  are 
affected.  This  will  escape  from  long  redbplays  and  finds,  but  it  may  still  take  a  while  for  Caesar 
to  finbh  whatever  ebe  it  was  doing. 
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1.  latrodactioa 

Various  pre-generated  cells  are  made  available  to  the  layout  designer  for  use  in  custom  designs  laid 
out  using  cfl  or  cacaar.  The  various  cells  are  to  be  used  with  the  particular  technology  under  which 
they  are  listed.  The  designer  should  avoid  using  the  same  names  of  these  symbols  when  designing  his 
own  symbols. 

1.1.  aMOS  CcU  Ubrary 

These  cells  were  provided  courtesy  of  MOSIS,  and  as  such  correspond  to  MOSIS  specifications  for 
fabrication.  They  are  current  as  of  April  1984.  For  more  information  on  the  pads  and  padframes, 
refer  to  the  MOSIS  document  nmotJoe  included  in  the  cells’  source  directory. 

1.1.1.  Fadframat 

Pin  1  of  these  padframes  is  connected  to  the  substrate,  and  therefore  should  not  be  used  for  a 
signal  line. 

28p23b34  •  28  pin  frame  with  dimensions  of  2300  by  3400  microns  ; 

28p4ds34  •  28  pin  frame  with  dimensions  of  4600  by  3400  microns  ; 

40^b34  •  40  pin  frame  with  dimensions  of  4600  by  3400  microns  ; 

40p46a6S  •  40  pin  frame  with  dimensions  of  4600  by  6800  microns  ; 

40p69i6S  •  40  pin  frame  with  dimensions  of  6900  by  6800  microns  ; 

64p46a6S  -  64  pin  frame  with  dimensions  of  4600  by  6800  microns  ; 

64p69a6S  •  64  pin  frame  with  dimensions  of  6900  by  6800  microns  ; 

64p79a92  •  64  pin  frame  with  dimensions  of  7900  by  9200  microns  ; 

84p69i68  *  84  pin  frame  with  dimensions  of  6900  by  6800  microns  ; 

84p79a92  •  84  pin  frame  with  dimensions  of  7900  by  9200  microns  ; 

1.1J.  Pads 

The  names  of  some  of  these  cells  have  been  shortened  due  to  system  limits  on  the  length  of 
filenames.  The  MOSIS  names  are  listed  in  parentheses  with  the  renamed  version  ahead  of  them 
in  boldface. 

PadVdd  •  VDD  pad  ; 

PadGraand  •  GND  pad  ; 

Padln  •  Protected  signal  input  pad  ; 

PadOnt  •  Output  pad  ; 

PadClkO  (PadClockedOut)  •  Clocked  output  pad  ; 

PadSStata  (PadTriState)  -  Tri-state  input/output  pad  ; 

PadClkBar  (PadCIockBar)  •  Two-phase  non-overlapping  clock -bar  pad  ; 
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1.2.  CMOSPW  Cell  Library 

These  cells  are  intended  for  fabrication  under  the  MOSIS  3  micron  CMOS  process  'CBP2',  and 
correspond  to  MOSIS  qsecifications.  They  do  not  use  second  poly  or  metal,  and  were  laid  out  using 
lambda  »  1  micron.  Tbe  pads  and  padframes  are  provided  courtesy  of  Paul  Bassett  of  the  Mas¬ 
sachusetts  Institute  of  Technology.  For  a  description  of  the  differences  between  the  three  pad  groups 
covered  below,  as  well  as  a  more  complete  description  of  the  individual  pad  drivers  and  padframes, 
see  Appendix  A  on  the  3-micron  bulk  cmos  pads  and  padframes. 


1J.1.  PadfraaMS 

Pin  1  of  these  padframes  is  connected  to  the  substrate  and  should  not  be  used  for  a  signal  line. 

28p4<x34  -  28  pin  padframe  with  dimensions  of  4600  by  3400  microns; 

40p46x68  •  40  pin  padframe  with  dimensions  of  4600  by  6800  microns; 

40p69i68  -  40  pin  padframe  with  dimensions  of  6900  by  6800  microns; 

64p69x68  •  64  pin  padframe  with  dimensions  of  6900  by  6800  microns; 

64p79x92  -  64  pin  padframe  with  dimensions  of  7900  by  9200  microns; 

84p79i92  -  84  pin  padframe  with  dimensions  of  7900  by  9200  microns; 

1 J  Granp  1  Pads 

These  pads  are  the  largest  of  the  three  groups  of  CMOSPW  pads  provided,  measuring  300  by  640 
microns. 

padloat  -  Output  pad; 

padlouC-ttl  •  TTL  output  pad; 

padlts  •  Tristate  pad; 

padlln  -  Input  pad; 

padlbla  -  Buffered  input  pad; 

padlbln-ttl  -  Buffered  TTL  input  pad; 

padlgpd  •  Ground  pad; 

padlfdd  •  Vdd  pad; 

padlspacc  •  Spacer  pad  for  padframes; 

padl  -  Complete  group  of  the  padl  cells; 

U.3.  Graup  2  Pads 

This  group  has  pads  measuring  200  by  430  microns,  and  does  not  include  any  output  pads. 

pad21n  -  Input  pad; 

pad2btn  -  Buffered  input  pad; 

pad2blB-ttl  -  Buffered  TTL  input  pad; 

pad20id  -  Ground  pad; 

pad2vdd  -  Vdd  pad; 

pad2apaes  -  Spacer  pad  for  padframes; 

pad2  •  Complete  group  of  the  pad2  cells; 

U4.  Granp  3  Pads 

Group  3  contains  an  only  unbuffered  input  pad,  with  a  Vdd  and  Ground  pad,  all  being  200  by 
306  micron  size. 

padJlB  -  Input  pad; 

pad30id  -  Ground  pad; 

padSvdd  •  Vdd  pad; 

pad3apacs  -  Spacer  pad  for  padframes; 

pads  -  Complete  group  of  the  pad3  cells; 
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U  BiflaccllaBcoai  Celia 


Refer  to  Appendix  B  for  descriptions  of  symbols  as  well  as  testing  information. 

_  •  Short  guard  ring  (from  MTT); 

_ •  Long  guard  ring  (from  MIT); 

Inv  •  Basic  inverter; 

naadl  •  Two  input  nand  gate; 

nandS  -  Three  input  nand  gate; 

nandd  •  Four  input  nand  gate; 

nor2  -  Two  input  nor  gate; 

norS  •  Three  input  nor  gate; 

aor4  -  Four  input  nor  gate; 

xorl  •  Two  input  ezclusive^r  gate; 

clkinv  •  Clocked  inverter; 

scUlnv  -  Two  input  inverted  selector; 

dlnteh  •  D  Type  latch; 

.  D  Type  latch  with  reset; 
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CMOSPW  PADS  AND  PADFRAMES 


These  pads  are  intended  for  fabrication  under  the  MOSIS  3  micron  CMOS  process  'CBPMZ*. 
They  do  not  use  second  poly.  They  were  laid  out  using  lambda  «  1  micron,  lliey  are  provided 
courtesy  of  Paul  Bassett  ^  the  Masmhusetts  Institute  of  Technology. 
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1.  ThtPadTjrpcs 

The  pads  are  divided  into  3  groupa.  All  of  the  pads  in  each  group  are  compatible  with  the  other 
members  of  its  group  but  the  groupa  are  not  compatible  with  each  other  due  to  power  bus  mismatches. 
Some  of  the  pertinent  properties  ^  each  of  the  groupa  are  briefly  discussed  below  followed  by  a  brief 
discussion  of  each  of  the  pad  types.  Members  of  different  groups  that  have  the  same  function  are 
differentiated  by  a  number  in  the  name  e4.  padlln  vs  pad21n:  since  Group  1  has  a  complete  set  of 
pads,  each  type  of  pad  will  be  discussed  briefly  only  for  that  group.  In  particular,  note  that  the  pad2 
and  pad3  groupa  do  not  have  the  via  and  second  layer  metal  layers  over  the  pads  required  for  the  pro¬ 
cess 'CBPMT. 


2.  Gronp  One 

This  group  is  the  only  complete  group  and  the  pads  in  this  group  are  also  the  largest  pads.  All  of  the 
pads  ate  300  x  640  microns.  This  size  is  dictated  mostly  by  the  size  of  driver  transistors  and  the  input 
buffer  stages  on  the  output  pads;  however,  the  pads  have  been  expanded  somewhat  to  fit  the  pad-to- 
pad  qmcings  of  the  MOSIS  standard  padframes  more  closely.  Two  consequences  of  this  are  that  the 
pads  could  be  made  sli^tly  smaller  if  this  is  desired  or  the  spacings  of  the  driver  transistors  could  be 
increased  slightly  more  to  provide  some  additional  latchup  protection.  The  input  protection  on  all  of 
the  input  pads  consists  of  a  well  resistor,  approximately  20  x  20  microns,  followed  p-f-to-snbstrate  and 
n-t-to-well  diodes  providing  additional  clipping  above  Vdd  and  below  Gnd,  both  diodes  are  approxi¬ 
mately  IS  X  15  microns.  These  pads  have  two  Vdd  buses  and  one  Ground  bus.  The  top  Vdd  bus  is  60 
microns  wide  and  the  bottom  Vdd  btis  is  20  microns  wide  and  has  a  20  micron  wide  strip  of  n-f 
diffusion  under  it  providing  a  guard  ring  to  separate  the  pads  from  the  internal  circuitry,  this  guard 
ring  is  only  broken  where  the  inputs  and  outputs  to  the  pads  cross  it.  The  Ground  bus  which  runs 
through  the  middle  of  the  pads  is  74  microns  wide.  The  input  and  output  signal  lines  extend  past  the 
lower  Vdd  bus  by  6  microns  to  allow  connecting  to  them  without  design  rule  violations  or 
modifications  to  the  pads.  Therefore,  even  though  all  of  the  pads  have  their  lower  left-hand  comer  at 
0,0,  the  lower  left-hand  comer  of  the  lower  Vdd  buses  are  at  0,6. 

padlout  -  output  pad.  While  this  is  intended  for  driving  principally  capacitive  loads  such  as 
other  MOS  devices,  it  can  sink  current  for  TTL.  The  signal  is  presented  at  point  *DATA*.  It 
presents  a  small,  though  not  minimal,  load  on  this  point.  Experiments  show  that  it  can  source  or 
sink  about  30ma,  and  has  a  delay  of  about  20ns  into  a  very  light  load  and  2Sns  into  SOpf. 

pndlottl  -  TTL  output  pad.  This  pad  is  simflar  to  the  regular  output  pad  except  that  it  has  an 
n-type  pullup  and  the  input  buffer  hu  been  changed  to  drive  the  pullup  and  pulldown 
separately.  Hiis  pad  is  experimental  in  that  it  has  not  ever  been  fabricated  ;  in  iplce  it  simulates 
correctly,  it  pulls  HIGH  to  between  2S  and  3  volts.  How  high  it  will  pull  in  real  operation  is  the 
major  point  in  question.  If  it  does  pull  high  enough  for  TTL  compatibility,  it  should  be  faster 
than  the  regular  output  pad. 

padlts  -  bidirectional  tristate  pad.  If  point  'OUT-ENAB'  is  set  low,  the  pin  is  left  to  float,  and 
whatever  signal  comes  in  from  the  outside  appears  at  point  *IN'  (which  is  not  buffered).  If  point 
'OUT-ENAB*  is  set  high,  the  signal  on  point  'OUT*  is  placed  on  the  pin  (and  is  also  available 
on  'IN').  This  presents  a  fairly  small,  though  not  minimal,  load  on  'OUT*,  but  a  moderately 
heavy  load  (sorry)  on  'OUT-ENAB*. 

padlln  -  unbuffered  input  pad.  This  has  the  lightning  arrestor'  resistor  and  protective  diodes, 
but  no  logic.  The  signal  appears  at  point  *DATA*. 

pndlbin  -  buffered  input.  It  presents  both  the  tme  data  at  the  point  labeled  'DATA*,  and  the 
inverted  data  at  '-DATA*.  Both  are  driven  by  fairly  strong  buffers. 

pndlblt  -  TTL  input  pad.  This  has  input  amplifiers  designed  to  have  a  threshhold  near  U  volts 
for  sensing  the  output  of  TTL  chips.  It  presents  both  the  tme  data  at  the  point  labeled 
'DATA',  and  the  inverted  data  at  '-DATA*,  though  the  latter’s  threshhold  is  not  offset  as  far  as 
it  should  be.  The  output  from  'DATA*  is  fairly  strong  but  the  '-DATA*  output  is  weak. 
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padlffid,  padlvdd  -  Vdd  and  Gnd  pads.  The  appropriate  voltages  come  out  on  100  micron  wide 
metal  lines.  The  ground  bus  is  broken  in  the  Vdd  pad  and  the  lower  Vdd  bus  is  broken  on  the 
Gnd  but  the  guard  ring  does  continue  under  the  ground  line,  without  any  contacts  (obviously). 

padlpp  -  spacer  for  pad  frames.  This  cell  is  mainly  meant  for  making  it  easy  to  fill  in  spaces 
between  pads;  all  it  contains  is  the  three  power  and  ground  buses. 

_  -  short  guard  ring.  This  cell  is  a  40  micron  long  piece  of  the  20  micron  wide  guard  ring. 

_ -  long  guard  ring.  This  cell  is  a  400  micron  long  piece  of  the  guard  ring. 

padl  -  the  complete  group.  A  cell  containing  an  instance  of  every  cell  in  the  group. 

3.  Group  Two 

The  pads  in  the  second  group  are  much  smaller  than  those  in  the  first  group,  200  x  430  microns.  This 
size  is  dictated  by  the  size  of  the  buffers  on  the  buffered  input  pads.  There  are  no  output  pads  in  this 
family.  Each  of  the  pads  again  has  two  Vdd  buses,  which  are  both  20  microns  wide,  and  one  Ground 
bus,  which  is  28  microns  wide.  The  input  protection  is  the  same  as  for  the  Group  1  input  pads  and 
there  is  also  a  20  micron  wide  guard  ring  under  the  lower  Vdd  bus. 

4.  Group  Thraa 

This  group  actually  consists  of  just  an  unbuffered  input  pad  so  the  size  of  the  other  pads,  Vdd  etc.,  is 
dictated  by  this  pad  and  is  200  x  306  microns.  This  pad  has  a  30  wide  upper  Vdd  bus,  a  10  micron 
wide  Ground  bus  and  a  20  micron  wide  lower  Vdd  bus  with  the  guard  ring  under  it  like  the  other 
pads.  The  input  protection  on  this  pad  is  the  same  as  on  the  others. 

5.  MOSIS  Standard  Pad  Frames 

Pad  frames  have  been  developed  for  some  of  the  MOSIS  standard  pad  frames.  The  frames  contain  the 
indicated  number  of  pads,  all  of  which  are  initially  unbuffered  input  pads.  The  pads  are  arranged  to 
meet  the  MOSIS  specifications  and  where  necessary,  the  padlsp  instance  hu  been  used  to  fill  in  the 
buses  and  the  guard  ring  in  between  the  pads.  AIm,  each  of  the  pad  frames  has  instantiated  in  the 
middle  of  it  a  set  of  the  available  pads.  Since  the  output  pads  are  fairly  large,  not  all  of  the  padframe 
placing  would  allow  using  all  of  the  allotted  pins,  only  those  frames  that  allow  a  full  complement  of 
pads  have  been  implemented;  the  available  frames  are: 


FRAME 

NAME 

DIE  SIZE 
(MICRONS) 

INTERIOR  PROJECT 
SIZE 

PINS/PACKAGE 

PIN  ROW 
SPACING 

28p46x34 

4600x3400 

3320  X  2120 

28  DIP 

0** 

40p46x68 

4600  x  6800 

3320  x  5520 

40  DIP 

0j6' 

40p69x68 

6900  x  6800 

5620  X  5520 

40  DIP 

0j6' 

64p69x68 

6900  x  6800 

5620  x  5520 

64  DIP 

0.9' 

64p79x92 

7900  x  9200 

6620  X  7920 

64  DIP 

0.9* 

84p79x92 

7900  x  9200 

6620  x  7920 

84  PGA 

- 
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CMOSPW  CELL  DESCRIPTIONS 


Herein  is  contained  a  description  of  most  of  the  standard  celb  available  in  the  CMOSPW  cell  library. 
At  the  end  of  this  appendix  is  located  a  writeup  on  simulation  conditions. 
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OS/OUSS 


CMOSPW  LIBRARY  CELL  INV 


INVERTER 


NOTES: 

1)  rail  separation:  41  X 

2)  bounding  box  (x  xy  ):  33X  x56X 

Table  values  from  SPICE  simulation 


CAESAR  rUc:  SUW_VLSI_TOOLS/src/celIib/cmospw/invxa 
OB  fllaa:  $UW_VLSI_TOOLS/src/ceIlib/cmospw/{invatt4nvxym} 


CMOSPW  LIBRARY  CELL  NAND3 


3-INPUT  NAND 


CAESAS  nit:  SUW_VLSI_TOOLS/src/ceUib/cmospw/aaad3£a 

DB  nict:  $UW_VLSI_TOOLS/src/ceIItb/cinospw/{nta<13att,  nand3.syin} 


onoa> 


CMOSPW  UBRARY  CELL  NOR4 


4-INPUT  NOR 


r=A-»'«+c+o 


Ncarcft  FnactloBal 
Eqalvalnt: 

CMOS  4002 
TTL742S 


CAESAR  nitt  $UW_VLSI_TOOLS/srcycelUb/cmospw/Dor4jCi 

DB  fllct:  SUW_VLSI_TOOLS/src/celUb/cmospw/{aor4att,  aor4.sym} 


Omit  SckMMdc  DlagnoB 


NOTES: 

1)  rail  sq)aration:  44  X 

2)  bouDding  box  (x  xy  ):  S2X  xS9X 

Table  values  from  SPICE  simulation 


CAESAR  nie:  $UW_VLSI_TOOLS/src/celIib/cmospw/cIkinv£a 

DB  flics:  SUW_VLSl_TOOLS/src/cellib/cmospw/{clkinvAtt,  clkinvxym) 


CMOSPW  LIBRARY  CELL  DLATCH 


D-LATCH 


Trath  Tabte 

c[c-|d||o 
1  0  T|7 
7  0  oil? 
e|  1 Ixfo 


Ncarnt  Foacdoaal 
Eqalvalnt: 

C 


TTL  74LS77 


Nodes 


Inottt  Load 


;  CkanctMtrtiM  Van  •*  5V 


reaOM 

Laad-1  |La^-lt 


Tn  Tyr 


ftopacaiioa  delay 
(bi|b  to  low) 


Propagadoo  delay 
Go«  to  biib) 


Output  fall  tioM 


Output  rise  tiuM 


NOTES: 

1)  rail  sqiaration:  S8  X 

2)  bounding  box  (x  xy );  77X  x73X 

Table  values  from  SPICE  simulation 


CAESAR  nia:  $UW_VLSI_TOOLS/src/celiib/cmospw/dlatch«a 

DB  flics:  SUW_VLSI_TOOLS/src/cellib/cmospw/{dlatchatt,  dlatchsym} 


CMOSPW  UBRARY  CELL  DLATCHR 


D-LATCH  WITH  RESET 

Trath  Tabte 

c 

C-  n  D  Q 

1 

0  0  D  O 

s 

1  S  X  o 

X 

X  t  X  0 

Nearat  Fonctlonal 

Eqalvalent: 

Nods 


lopot  Load 


clockBaft 
iat  clockt 


OUWIdtktMX 

oatt 


mb  cloekb  reaeib  ovib 

dockBarb 


V™,  -5V 


rarnom 

Laa«-M 


ftopagadoa  delay 
(higb  to  low) 


Piopacatioa  delay 
(low  to  hiah) 


Oaipat  tall  tiaw 


NOTES: 

1)  rail  separation:  S8  X 

2)  bounding  box  (x  xy  );  88X  x73X 

3)  Reset  propagation  delay:  2.0  6j0 

4)  Reset  fall  time:  iS  11.S 

Table  values  from  SPICE  simulation 


CAESAR  nis:  $UW_VLSI_TOOLS/src/eelUb/cmospw/dlatchr£a 

DR  flies:  $UW_VLSI_TOOLS/src/ce(lib/cmospw/(dlatchratt,  diatchrxym} 


Simulation  Conditions 


All  CMOSPW  standard  cells  were  simulated  by  spice  (a  circuit  simulator  program).  The  circuits  were 
generated  from  the  layout  artwork  by  first  creating  CIF  (Caltech  Intermediate  Form)  files  from  the 
layout.  The  circuit  extraction  program  mcxtra  was  then  used  to  extract  the  circuit  from  the  CIF  file. 
Following  are  some  electrical  data  of  the  timing  simulations. 

Temperature  parameter  was  set  to  27*C 

Control  signal  transition  time  was  S  ns 

VDD  »  5V  GND  »  OV 

Output  fall  time  (frm)  was  measured  from  90%  (45V)  point  to  10%  point  (05V)  of  the  output 
signal. 

Output  rise  time  (trur)  was  measured  from  10%  (05V)  point  to  90%  point  (45V)  of  the  output 
signal. 

Propagation  delay  (r^^  or  t^u,)  was  measured  from  the  control  signal  S0%  point  (25V)  to  the 
output  signal  S0%  point  (25V). 

Output  disable  time  from  high  level  (r^z)  was  measured  as  following.  Output  signal  was  pre* 
charged  to  high  level  (SV)  at  the  beginning  of  the  simulation.  was  measured  from  the  con¬ 
trol  signal  S0%  point  to  the  output  signal  90%  point,  i.e.  05V  swing. 

Output  disable  time  from  low  level  (r^u)  was  measured  as  following.  Output  signal  was  set  to 
low  level  (OV)  at  the  beginning  of  the  simulation,  was  measured  from  the  control  signal 
S0%  point  to  the  output  signal  10%  point  (05V  swing). 

Enable  time  to  high  level  (tpzw  )  was  gained  by  setting  the  output  signal  to  low  level  at  the  begin¬ 
ning  and  measured  from  the  control  signal  S0%  point  to  the  output  50%  point. 

Enable  time  to  low  level  (r^  )  was  gained  by  pre-charging  the  output  signal  to  high  level  at  the 
beginning  and  measured  from  the  control  signal  50%  point  to  the  output  50%  point. 

For  all  cells  (except  pads),  fan  out  load  -  1  means  loading  the  celt  with  one  inverter;  fan  out 
load  >  10  means  loading  the  cell  with  10  inverters  in  parallel. 

For  the  pads,  fan  out  load  of  1  means  a  loading  of  5  pF  while  fan  out  load  of  10  means  a  loading 
of  50  pF.  During  the  measurement,  output  of  each  pad  was  load  with  2  resistors:  one  16.67K 
resistor  from  Vdd  to  output  and  one  5K  resistor  from  output  to  Gnd. 
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Following  is  a  list  of  the  SPICE  model 
eter  description)  that  were  used: 


parameter  values  (see  SPICl 


PMOS 

NMOS 

LEVEL 

2 

2 

VTO 

-0.9 

0.9 

CGSO 

4.0E-10 

S2E-10 

CGDO 

4.0E-10 

S2E-10 

CGBO 

4.0E-10 

S2E-10 

RSH 

9S.0 

200 

CJ 

2i)E-4 

32E-4 

CJSW 

4.SE-10 

9E-10 

JS 

lJDE-4 

l.OE-4 

TOX 

SjOE-8 

S.OE-8 

NSUB 

SjOEIS 

25E16 

TPG 

-1 

+1 

XJ 

6i)E-7 

80E-7 

LD 

SjOE-7 

6.4E-7 

UO 

200 

450 

UCRTT 

8jOE4 

8.0E4 

UEXP 

0.15 

0.15 

UTRA 

03 

03 

VMAX 

SOE4 

50E4 
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NETLIST  User’s  Guide 


VWISW  VLSI  Cotuortium 


Department  of  Computer  Science 
University  of  Washington 
Seattle,  WA  9819S 


(This  document  is  baaed  on  portions  of  the  document  *User’s  Guide  to  NET,  PRESIM  and 

RNLyNL.*  by  Christopher  J.  Terman,  Laboratory  for  Computer  Science,  MJ.T^  Cambridge,  MA 

02139.) 

To  run  NETLIST  type 

nctUst  iiifiU  [<mtfit0]  (*0]  (*8#)  [-d#,#!  (-ai#,)#! 

inflie  is  the  name  of  the  NETLIST  input  file,  if  outfile  is  specified,  that  file  is  used  for  output.  The 

options  are: 

-9  old  format  input,  size  specifications  are  taken  to  be  length/width  rather  than 

width/length. 

-Ueek  Uses  teeh  in  the  technology  portion  of  the  units/tech  line  at  the  beginning  of  the  simulation 
file  produced  (Default  is  ???,  unknown). 

-auniis  Sets  the  number  of  centi-microns  per  lambda  to  units  (Default  is  2S0).  Warning:  The 
'units*  set  by  this  option  appear  in  the  comment  line  of  the  Mm  file.  This  value  is  not  used 
by  PRESIM  and  does  not  influence  an  RNL  simulation. 

•s#  use  specified  number  as  initializer  for  internal  node  names;  useful  when  you  want  to 
merge  the  results  of  separate  NETLICT  runs. 

•dfP,#  set  the  default  width  (first  number)  and  length  (second  number)  for  depletion  devices. 
The  defaults  are  8  and  2. 

•cd>,d>  like  -d  except  for  enhancement  devices.  The  defaults  are  2  and  2. 

•I#,#  like  -d  except  for  intrinsic  devices.  The  defaults  are  2  and  2. 

•1#,#  like  Hi  except  for  low-power  devices.  The  defaults  are  2  and  2. 

•p#,#  like  -d  except  for  p-channel  devices.  The  defaults  are  2  and  2. 

A  NETLIST  file  can  insert  other  NETLIST  files  by  using  the  include  com-  mand: 

Include  filename  Jut 

The  single  argument  must  be  a  string  (ie.,  enclosed  in  quotes). 
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Available  through  NETLIST  are  all  the  regular  built-in  functions  of  RNL  (i.e.,  a  subset  of 
standard  LISP  primitivies)  ~  see  RNL  documentation  for  a  description  of  these  subroutines.  In  addi¬ 
tion,  NETLIST  offers  some  spe-  cial  functions  useful  for  building  a  description  of  a  transistor  net¬ 
work.  These  functions  are  described  below. 

NETLIST  is  a  macro-based  language  for  describing  networks  of  sized  transistors.  Names  in 
NETLIST  refer  to  nodes,  which  presumably  get  inter-  connected  by  the  user  through  transistors.  A 
node  name  has  two  forms 

(h  width  length) 

n  is  the  name  of  the  network  node,  length  and  width  specify  a  transistor  size.  This  is  used  in  NET- 
LIST  constructs  where  mention  of  a  name  causes  creation  of  a  transistor. 

n 

n  is  the  name  of  the  network  node;  when  transistor  sizes  are  required  they  are  taken  from  the 
appropriate  defaults 

When  using  a  name  to  refer  to  a  node,  it  must  first  be  'declared*  (this  allows  typo’s  to  be  caught 
early  on).  Nodes  are  declared  by  using  the  node  statement  or  the  local  statement  (see  below).  The 
node  statement  looks  like: 

(node  nl  h2  n3  ...) 

where  nl,  n2,  etc  are  the  names  to  be  declared.  Note:  when  using  structured  names  (see  the  repeat 
statement)  only  the  first  component  has  to  be  declared. 

The  interconnect  capacitance  associated  with  a  node  can  be  q>ecified  as  follows: 

(capacitance  n  1234) 

(setq  pf'Sq-micron-ef -diffusion  lOe-4) 

(capacitance  n  (*  13  pf-sq-micron-of -diffusion)) 

The  first  argument  is  the  name  of  the  node,  the  second  the  capacitance  in  pf  (must  be  a  number). 

A  resistance  can  be  specified  as  follows: 

(resistor  nl  n2  1500) 

The  first  two  arguments  (nl  and  n2)  are  the  names  of  the  nodes  to  which  the  resistor  is  connected,  the 
last  argument  is  the  resistance  value  in  ohms  (must  be  a  number). 

An  electrical  node  can  be  given  several  names  by  using  the  connea  statement: 

(connect  nl  n2  n3  ...) 

The  names  nl,  n2,  etc.  will  all  refer  to  the  same  electrical  node.  This  statement  is  useful  for  connect¬ 
ing  i/o  signals  to  the  edge  of  an  array  generated  by  a  repeat  statement. 

The  voltage  threshold  for  logic  high  and  low  states  can  be  set  by  the  NETLIST  command  thres¬ 
hold: 

(threshold  n  02  OJB) 

would  set  the  logic  low  threshold  for  node  n  to  02  (normalized  voltage)  and  the  high  threshold  to  OR. 
If  no  threshold  is  specified,  the  node  will  be  given  the  default  thresholds  as  given  in  the  configuration 
file  for  PRESIM  (see  PRESIMDOC  for  details). 

The  'delay*  of  a  node  (the  transition  times  for  changes  in  the  node’s  value)  can  be  specified  by 
user  with  the  delay  command: 

(delay  n  plh  phi) 

where  plh  and  phi  are  integers  specifying  the  low-to-high  transition  delay  and  the  high-to-Iow  delay 
respectively.  Delays  are  specified  in  RNL  time  units  (1/lOth  nanosecond).  If  you  do  not  specify  a 
delay  for  a  node,  RNL  will  calculate  one  based  on  the  impedence  of  the  driving  transistors  and  the 


UW/NW  VLSI  Release  3J) 


-2- 


06/01/85 


UW/NW  VLSI  Consortium 


NETLIST  User's  Guide 


capacitance  of  the  node;  user-specified  deUys  override  the  usual  RNL  calculation. 

(ratio  gattjratio) 

set  a  global  parameter  gate_ratio  for  use  in  cnand.  cnor,  cinvert  and  the  transistors  connected  to  the 
input  signal  in  the  clkinv.  Default  gate.ratio  is  2.0. 

Node  interconnections  are  accomplished  by  one  of  the  following  NETLIST  statements: 

(tratu  g  t  d  [w  [/Il> 

(etraiu  gsd[w  (/]]> 

enhancement  mode  transistor  with  gate  g.  source  s,  and  drain  d.  1  and  w  specify  length  and  width  of 
transistor  (can  be  ommited). 

(dtraiu  g  s  d[w  [/]]1 

like  etrans,  except  depletion  mode  transistor 
(itrana  g  s  d  [w  (/]]> 
like  etrans,  except  intrinsic  transistor 
(Itratu  g  a  d  [w  [/]]> 

like  etrans,  except  low-power  transistor 
(ptraiu  g  a  dlw  (/]]; 
like  etrans,  except  p-channel  transistor 
(tgate  out  in  node  nodebar) 

wires  a  CMOS  tranmission  gate  from  the  signals  node  and  nodebar.  The  order  is  alphebetical,  the  is 
the  n  type  is  gated  by  node  and  the  p  type  by  nodebar.  The  size  of  the  p  type  device  is  set  explicitly 
on  the  nodes  node  and  nodebar  not  by  the  ratio  commands.  Additional  arguments  (more  control) 
may  be  added  but  there  must  be  an  even  (2N)  number  or  it  will  complain.  Nodes  in  and  out  are  have 
their  usual  meanings. 

(pullup  a) 

depletion-mode  pullup  (to  vdd)  of  a. 

(pulldown  a  n-I  ...  n-k) 

chain  of  k  transistors  from  a  to  gnd,  gates  of  transistor  are  n-l, ....  n-k. 

(invert  a  b) 

two-transistor  NMOS  inverter  with  output  a  and  input  b. 

(cinvert  a  b) 

two-transistor  CMOS  inverter  with  output  a  and  input  b.  The  size  of  the  p  type  transistor  is  deter¬ 
mined  by  the  current  value  of  ratio.  See  the  command  ratio  for  adjusting  this  value.  Default  2.0. 

(clkinv  out  in  elk  elk-) 

CMOS  clocked  inverter.  This  function  builds  a  clocked  inverter  from  elk,  elk-  and  in  nodes.  Clk 
gates  the  n  type  transistor  and  elk-  the  p  type  (just  like  tgate).  The  size  of  the  p  device  gated  by  in  is 
determined  from  the  current  value  of  gate^ratio  (set  by  the  ratio  command).  The  size  of  the  p  device 
gated  by  nodes  elk  and  elk-  are  set  using  standard  node  syntax  and  does  not  use  the  ratio  command. 

(nor  a  n-I  ...  n-k) 

pulls  up  a,  and  creates  k  transistors  from  a  to  gnd  controlled  by  n-l  through  n-k. 

(cnor  a  n-I  ...  n-k) 
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produces  a  CMOS  nor  gate  with  output  a  and  inputs  n-1  ...  n-k.  The  node  a  is  pulled  up  with  a  chain 
p  type  devices  and  is  connected  to  gnd  with  the  n  type  devices.  Both  sets  are  gated  by  the  list  of 
inputs.  The  size  of  the  p  type  transistor  is  determined  by  the  current  value  of  ratio.  See  the  com¬ 
mand  ratio  for  adjusting  this  value.  Default  2j0. 

(nand  a  n-1  ...  n-k) 

equivalent  to 

(pullup  a) 

(pulldown  a  n-1 ...  n-k) 

(cnand  a  n-1  ...  n-k) 

produces  a  CMOS  nand  gate  with  output  a  and  inputs  n-1  ...  n-k.  The  node  a  is  connected  to  Vdd 
through  the  p  type  devices  and  pulled  down  by  chain  of  n  type  devices.  Both  sets  are  gated  by  the  list 
of  inputs.  The  size  of  the  p  type  transistor  is  determined  by  the  current  value  of  ratio.  See  the  com¬ 
mand  ratio  for  adjusting  this  value.  Default  2.0. 

(and-or-invert  a  (n-l  ...  n-k)  ...  (m-I  ...  m-l)) 

equivalent  to 

(pullup  a) 

(pulldown  a  n-1  ...  n-k) 

(pulldown  a  m-l  ...  m-l) 

Iteration  construct  is  repeat  statement: 

(repeat  index  low  high 
((local  1-1 ...  I-j)] 

...) 

where  index  will  be  given  successive  values  starting  with  low  and  finishing  with  high.  You  can  u:e  the 
index  in  structured  names,  e.g.: 

fooindex  foo.(l-l-  index)  foo.(l-  index).bar  ... 

local  variables  are  described  under  macros. 

For  ease  of  circuit  entry,  the  user  can  build  and  call  parameterized  macros,  macro  definitions 
have  the  form 

(macro  n  (p-I  ...  p-k) 

[(local  l-I  ...  l-j)] 

...) 

where  n  is  the  name  of  the  new  NETLIST  function  being  created,  p-1  ...  p-k  are  the  formal  parame¬ 
ters,  1-1  ...  l-j  are  the  optional  local  node  names  used  in  the  body. 

The  macro  is  invoked  as  follows: 

(n  a-1  ...  adt) 

which  pauses  the  body  to  be  interpreted  after 

1)  all  occurrences  of  p-1  in  the  body  have  been  replaced  by  a-1,  ete. 

2)  all  occurrences  of  1-1  in  the  body  have  been  replaced  by  a  new,  unique  node  name.  Unique 
names  will  be  a  number  (like  for  anonymous  nodes  in  pulldowns). 
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3.0  Example* 

In  the  following  examples 

e  g  s  d  1  w 

specifies  an  enhancement-mode  transistor  with  gate  g,  source  s,  and  drain  d  with  length  1  and  width  w. 
d  g  sd  I  w 

is  similiar,  except  transistor  is  depletion  mode. 

Quickie  examples: 

(invert  a  b) 
d  a  a  vdd  8  2 
e  b  a  gnd  2  2 

(invert  a  (b  17  5)) 
d  a  a  vdd  8  2 
e  b  a  gnd  5  17 

(invert  (a  2  2)  (b  2  4)) 
d  a  a  vdd  2  2 
e  b  a  gnd  2  4 

(nor  (a  16  2)  (b  2  4)  c  d) 
d  a  a  vdd  2  16 
e  b  a  gnd  4  2 
e  c  a  gnd  2  2 
e  d  a  gnd  2  2 

(and-cr -invert  a(b  c  d)  (e  f)  (g)) 
d  a  a  vdd  8  2 
e  b  a  1001  2  2 
e  c  1001  1002  2  2 
e  d  1002  gnd  2  2 
e  e  a  1003  2  2 
e  f  1003  gnd  2  2 
e  g  a  gnd  2  2 

Two  dimensional  array  of  foo's: 

(repeat  i  1  8  (repeat  j  1  8  fooij)) 


generates 

foo.1.1  foo.l2  foo.lJ  ...  foo.lJS 
foo2.1  ...  foo.8.8 

Simple  two-inverter  dynamic  memory  cell: 
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(macro  bitcell  (output  output-enb  input  input -enb  refresh) 
(local  a  b  c) 

(trans  input-enb  input  a  2  4) 

(invert  b  a) 

(invert  (c  2  2)  (b  2  8)) 

(trans  refresh  a  c) 

(trans  output-enb  e  output  2  4) 


(bitcell  bitO  renb  bitO  wenb  phi2) 


generates 

e  wenb  bitO  1001  4  2 
d  1002  1002  vdd  8  2 
e  1001  1002  gnd  2  2 
d  1003  1003  vdd  2  2 
e  1002  1003  gnd  8  2 
e  phi2  1001  1003  2  2 
e  renb  1003  bitO  4  2 

Assume  you  had  an  alu  bit-slice  macro  of  the  following  form 

(alu  carry-in  operand!  operand2  result  carry-out) 

then  the  following  macro  would  produce  an  n-bit  alu: 

(macro  ALU  (n  databusl  databus2  resultbus  ein  cout) 

(connect  ein  eoutJQ) 

(repeat  i  I  n 

(alu  eoutll-  i)  databusl  J  databus2J  resultbus!  couti)) 

(connect  cout  eoutn) 

) 

Instead  of  using  the  connect  statement  one  could  have  conditionalized  the  calculation  of  the  argu¬ 
ments  to  alu: 


(macro  ALU  (n  databusl  databus2  resultbus  cin  cout) 
(repeat  i  I  n 

(alu  (cond  ((-=  i  1)  cin)  (t  com  ft-  i))) 
databusl! 
databus2! 
resultbus! 

(cond  ((==  i  n)  cout)  (t  comji)))  )) 

) 

The  file  /usr/vlsi/nl/padsjiet  contains  the  following  macros: 

(input-pad  world)  ;  the  input  pad 

(output-pad  world  in)  ;  the  output  pad 

(tristate-pad  world  in  direction)  ;  the  tristate  pad 
(clockbar-pad  world  *phil  'phi2) ;  the  clock  pad 
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(This  document  is  baaed  on  portions  of  the  document  *User*s  Guide  to  NET,  PRESIM  and 
RNL/NL,”  by  Christopher  J.  Terman,  Laboratory  for  Computer  Science,  MJ.T^  Cambridge.  MA 
02139.) 


One  must  first  convert  the  .sim  file  to  a  network  file  suitable  for  use  by  RNL  or  NL  -  to  do  this 
we  run  PRESIM: 

presim  foojtm  foo  [cotrfig]  options... 

which  converts  the  file  foojim  into  a  binary  file  for  RNL/NL  called  foo. 

The  -g  option: 

Suppresses  the  sum-of-products  formation.  This  may  be  desired  if  you  think 
sum-of-products  is  formed  wrong  otherwise  the  advantages  of  the  transistor  and 
node  reduction  make  this  option  unattractive. 


The  •€  option: 

-cfile^ninvalue 

writes  a  list  of  node  names  and  capacitances  to  the  specified  file.  Only  capacitances  larger  than  min* 
value  will  be  included. 

The 't  option: 

•tfile  .min  value 

writes  a  list  of  transistors  and  RC  values  to  the  specified  file  ~  there  are  two  entries  for  each  transis¬ 
tor.  The  R’s  come  from  the  size  of  the  transistor,  C’s  from  the  source/drain  capacitance.  Only  RC 
values  larger  than  minvalue  will  be  included. 

The  -p  option: 

•presist.voltage 

provides  a  worse-case  estimate  of  the  circuit  power  consumption  by  assuming  that  all  the  pullups 
(DEP  or  LOWP  devices  with  drain^VDD)  are  all  on  simultaneously.  *VoItage*  specifies  the  supply 
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voltage,  for  example  *<pS*  specifies  a  VDD  of  S  volts.  The  result  is  printed  after  PRESIM  completes  its 
other  procesang.  When  figuring  the  resistance  of  a  pullup  device  the  'power*  characteristic  resistance 
as  set  in  the  config  file  is  used. 

Presim’s  results  are  dependent  on  a  number  of  parameters  that  vary  with  the  technology  used.  A 
set  of  variables  is  built  into  Presim  that  allow  calculations  to  proceed  when  the  optional  config  file  is 
not  present,  but  you  should  realize  that  these  values  do  not  correspond  to  any  particular  process.  The 
config  file  can  be  used  to  override  these  built-in  values.  The  correct  format  for  configuration  files  is 
given  with  the  following  example.  This  config  file  contains  the  default  parameter  values.  The  'lambda* 
parameter  specified  in  this  file  is  ignored  for  Am  files  in  the  UCB  format.  UCB  aim  files  have  their 
dimensions  specified  in  centimicrons.  The  'units'  parameter  in  MIT  format  aim  files  is  ignored  by 
presim,  see  the  Netlist  users  guide  for  details. 

(Resistor  values  not  explicitly  provided  in  the  configuration  file  are  estimated  by  linear  interpolation. 
The  resistor  values  are  stored,  sorted  first  by  width,  then  by  length  not  by  the  ratio.) 


parameter  value  comments... 

Lines  beginning  with  *;'  are  treated  as  all  comment.  The  parameter  names  and  their  default  values 
are: 


;  configuration  file  for  'standard*  MFC  process 


capm2a 

JDOOOO 

capm2p 

ROOOO 

capma 

.00003 

capmp 

.00000 

cappa 

D0004 

cappp 

ROOOO 

capda 

DOOlO 

capdp 

J00060 

cappda 

JOOOIO 

cappdp 

J00060 

capga 

i)0040 

;  2nd  metal  capacitance  ~  area,  pf/sq-micron 
;  2nd  metal  capacitance  ~  perimeter,  pf/micron 
:  1st  metal  capacitance  >•  area,  pf/sq-micron 
:  1st  metal  capacitance  -  perimeter,  pf/micron 
;  poly  capacitance  -  area,  pf/sq-micron 
;  poly  capacitance  ~  perimeter,  pf/micron 
:  n-diffusion  capacitance  -  area,  pf/sq-micron 
;  n-diffusion  capacitance  --  perimeter,  pf/micron 
;  p-diffusion  capacitance  -  area,  pf/sq-micron 
;  p-diffusion  capacitance  --  perimeter,  pf/micron 
:  gate  capacitance  ~  area,  pf/sq-micron 


lambda  25  ;  microns/lambda  (conversion  from  zim  file  units 

;  to  units  used  in  cap  parameters) 


lowthresh  03  ;  logic  low  threshold  as  a  normalized  voltage 
highthresh  OR  ;  logic  high  threshold  as  a  normalized  voltage 

cntpullup  0  ;  <> 0  means  that  the  capacitor  formed  by  gate  of 

;  pullup  should  be  included  in  capacitance  of  output 
;  node 

diffperim  0  ;  <> 0  means  do  not  include  diffusion  perimeters 

;  that  border  on  transistor  gates  when  figuring 
;  sidewall  capacitaiice  (*) 

subparea 0;  <>0  means  that  poly  over  transistor  region  will  not 
;  be  counted  as  part  of  the  poly-bulk  capacitor  (*) 
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diffext  0 


diffusion  extension  for  each  transistor,  i.e.,  each 
transistor  is  assumed  to  have  a  rectangular  source 
and  drain  diffusion  extending  diffext  units  wide  and 
transistor-width  units  high.  The  effect  of  the 
diffusion  extension  is  to  add  some  capacitance  to 
the  source  and  drain  node  of  each  transistor  -- 
useful  when  processing  the  output  of  NET  to  improve 
the  capacitive  loading  approximations  without  adding 
explicit  load  capacitors,  diffext  is  ^>ecified  in 
lambda  (it  will  be  converted  using  the  lambda  factor 
above). 


resistance  channel  context  width  length  resist 
;  this  command  specifies  the  equivalent  resistance  for  a  transistor 
:  of  type  channel  with  the  specified  width  and  length.  Transistors 
;  matching  this  entry  will  have  the  specified  renstance;  linear 
;  interpolation  is  done  if  the  width  and/or  length  is  not  matched 
;  exactly. 

;  channel  is  one  of  'enh*,  'dep',  'intrinsic*,  'low-power', 

;  'pullup',  or  'p-chan' 

;  context  is  one  of  'static*,  'dynamic-high*,  'dynamic-low',  or  'power* 
:  width  is  given  in  lambda 
;  length  is  given  in  lambda 
;  resist  is  given  in  ohms 


(*)  These  paramters  should  be  1  only  when  processing  the  output  of 
the  node  extractor.  They  cause  various  corrections  to  be  made 
to  the  interconnect  component  of  a  node’s  capacitance  -  usually 
only  extracted  xim  files  have  information  regarding  interconnect 
capacitance. 

PRESIM  uses  these  parameters  in  calculating  the  capacitance  for  each  electrical  node  and  the  resis¬ 
tance  for  each  transistor  channel. 


The  location  of  worst  case  config  files  for  different  technologies  can  be  found  in  the  technology 
manual  page  (use  the  UNIX  command  man  technology  5). 
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(This  manual  documents  version  42  (UW)  RNL.  The  manual  is  based  on 
Chris  Terman’s  manual  of  similar  title.) 


1.  INTRODUCTION 

RNL  is  a  timing  logic  simulator  for  digital  MOS  circuits.  It  is  an  event  driven  simulator  that 
uses  a  simple  RC  (resistance  capacitance)  model  of  the  circuit  to  estimate  node  transition  times  and  to 
estimate  the  effects  of  charge  sharing.  The  user  interface  is  a  simple  LISP  interpreter.  This  allows 
both  interactive  simulation  and  the  programming  of  complex  simulations.  See  Chapter  2  of  'Simula¬ 
tion  Tools  for  LSI  Design*  by  C.  Terman  for  details  of  the  algorithm.  A  short  introduction  to  the 
model  is  included  in  the  Theory  of  Operation'  section  of  this  guide. 

The  version  of  RNL  described  herein  is  verson  42  as  distributed  by  the  UW/NW  VLSI  Consor¬ 
tium.  It  differs  from  previous  versions  in  that  it  is  considerably  faster  for  many  simulations.  In  addi¬ 
tion  the  user  interface  has  been  augmented. 

To  use  RNL,  one  needs  jim  6Ie  for  the  circuit  to  be  simulated.  This  can  be  extracted  from  the 
mask  file  (e.g.,  CIF)  or  developed  using  NETLIST,  a  program  that  processes  textual  schematics. 

The  first  step  is  to  convert  the  Jim  file  to  a  network  file  suitable  for  use  by  RNL  by  running 
PRESIM: 

%  prcsim  foo  Jim  foo  [confUc]  [•cfllc.i^D]  {-ttlla^iiin]  [prcsist, voltage]  <  CR> 

Presim  converts  the  file  'foojim'  into  a  binary  file  for  RNL  called  *foo'.  The  other  parameters  ate 
optional  and  are  described  in  detail  elsewhere.  The  conversion  process  involves  the  computation  of 
the  effective  resistances  of  the  transistors  as  well  as  the  capacitances  of  the  circuit  nodes.  In  order  to 
have  a  consistent  estimation  of  capacitances  we  reccommend  that  if  you  are  using  the  circuit  extractor 
mcxtra  that  you  use  the  *-o*  option  to  force  the  program  to  output  the  dimensions  of  the  circuit  nodes 
rather  than  to  estimate  their  capacitances.  (See  the  PRESIM  documents  for  information  on  options 
and  sections  of  this  manual  on  calibration.) 

To  invoke  RNL.  either  type 
wml  <CR> 


or 


%  ml  cmdfllc  <  CR> 
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If  the  'cmdfile'  argument  is  provided  then  it  should  be  the  name  of  a  file  that  contains  a  sequence  of 
RNL  commands.  At  the  very  least  this  command  file  should  load  one  or  more  libraries  of  standard 
functions  and  should  read  in  the  binary  description  of  the  circuit  prepared  by  PRESIM.  For  all  but 
the  simplest  of  circuits  the  command  file  will  also  contain  commands  and  the  definitions  of  LISP  func¬ 
tions  written  by  you  to  help  in  your  simulation  by  performing  such  tasks  as  test  vector  generation  and 
the  simulation  of  the  environment  in  which  your  circuit  is  designed  to  operate. 

A  minimal  command  file  would  contain  the  commands: 

(load  'uwstdJ*) 

(load  'uwsimJ'^ 

(read-network  'foo") 

where  the  file  *foo*  was  prepared  from  a  *.sim*  file  by  PRESIM. 

When  the  end  of  the  command  file  is  reached,  input  is  taken  from  the  standard  input. 

2.  RNL  THEORY  OF  OPERATION 

It  is  not  necessary  to  have  a  detailed  understanding  of  the  internal  computations  of  RNL  in 
order  to  begin  to  use  it.  It  is,  however,  useful  to  have  a  general  idea  of  what  is  going  on.  In  particu¬ 
lar,  this  section  will  be  helpful  when  reading  the  discussion  on  some  of  the  limitations  of  RNL’s  cir¬ 
cuit  model.  The  rest  of  this  section  is  a  discussion  of  RNL’s  internal  computations  and  is  quoted 
directly  from  C.  Terman’s  original  RNL  User’s  Guide. 

The  RNL  simulator  are  designed  to  handle  ratioed  logic,  bidirectionality,  and  charge 
sharing/storage.  They  can  be  used  to  determine  the  functionality  and  approximate  timing  behavior  of 
circuits  commonly  found  in  digital  MOS  designs. 

RNL  uses  the  following  simple  recipe  for  rimulating  a  circuit.  Recall  that  PRESIM  has  esta¬ 
blished  the  capacitance  of  each  node  and  the  size  of  each  transistor.  (The  network  extractor  written 
by  C.  Baker  automatically  derives  both  from  the  mask  files;  if  the  network  is  derived  from  a  NET- 
LIST  description,  the  user  must  explicitly  specify  the  interconnect  capacitance  for  nodes  where  it  is 
important.) 

Once  input  values  have  been  assigned  by  the  user,  RNL  calculates  the  effects  of  the  new  values 
by  repeating  the  following  operations  until  no  further  nodes  change  values: 

(1)  when  nodes  are  added  to  the  network  (the  result  of  some  transistor  turning  on), 
compute  the  "charge  sharing^  implications  of  the  new  node’s  capacitance  and  logic 
state  on  its  electrical  neighbors. 

(2)  for  each  node  that  might  be  affected  calculate  V,,,„  and  R,,^ ,  the  parameters  for  the 
Thevenin  equivalent  circuit.  The  new  logic  state  of  the  node  is  determined  from 

v,*„. 

(3)  if  the  node  has  changed  state,  calculate  the  transition  time  using  the  node’s  capaci¬ 
tance. 

(4)  propagate  changes  (if  any)  to  other  nodes. 

Basic  to  the  operation  of  the  simulators  is  the  notion  of  an  event  -  an  event  specifies  (i)  a  node  in  the 
network,  (ii)  a  new  logic  state,  and  (iii)  a  time  at  which  the  node’s  value  is  changed  to  the  new  logic 
state.  RNL  maintains  a  list  of  events,  sorted  by  time,  that  tells  what  processing  remains  to  be  done. 
Whenever  the  user  changes  an  input,  an  event  is  added  to  the  list;  when  the  list  is  empty  the  network 
has  "settled*  and  RNL  waits  for  further  input. 

When  started  with  an  initial  list,  RNL  sequentially  processes  the  next  event  on  the  list,  stopping 
(1)  when  the  list  is  empty,  (2)  when  a  node  the  user  is  tracing  changes  value,  or  (3)  when  the 
specified  amount  of  simulated  time  has  elapsed.  Processing  an  event  entails 

(a)  removing  the  event  from  the  event  list. 

(b)  changing  the  node’s  state  to  reflect  its  new  value. 
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(c)  calculating  any  consequences,  i.e^  new  events,  resulting  from  the  node’s  new  value. 
First  all  nodes  that  might  be  affected  by  the  change  are  found  and  marked  -  this 
includes  the  source  and  drain  nodes  of  transistors  with  the  current  node  as  a  gate, 
and  all  nodes  connected  to  these  nodes  by  conducting  transistors  (the  search  through 
the  network  stops  only  when  an  input  or  a  non-conducting  transistor  is  reached). 
For  each  marked  node  two  calculations  are  made:  first  a  'charge  sharing”  calculation 
is  performed  (see  2.1)  to  model  changes  of  state  due  to  charging/discharging  of  the 
node  capacitances.  Second,  a  'final  value'  calculation  is  done  (see  section  22)  to 
determine  the  nodes  ultimate  logical  state. 

Since  nodes  are  only  added  to  the  event  list  when  their  values  change,  portions  of  the  circuit 
unaffected  by  the  current  set  of  changes  to  the  inputs  are  not  re-evaluated  ~  the  algorithm  is  event- 
driven  (sometimes  called  selective  trace). 

A  node  can  have  up  to  two  events  pending: 

(1)  a  'charge  sharing”  event  describing  an  immediate  change  in  the  node’s  state  due  to 
the  redistribution  of  charge  among  the  capacitors  for  nodes  on  the  connection  list. 
This  type  of  event  is  only  generated  when  a  node  is  added  to  a  subnetwork  (i«., 
when  a  transistor  turns  on). 

(2)  a  'final  value'  event  describing  what  the  final,  driven  state  of  the  node  will  be. 

The  simulation  computation  computes  both  types  of  events  for  each  node  and  then  does  the  following: 

(a)  when  a  new  charge  sharing  event  is  scheduled,  throw  away  pending  events  of  either 
flavor.  If  the  new  charge  sharing  event  is  for  the  same  value  that  the  node  currently 
has,  it  can  be  thrown  away  too,  i.e.,  the  node  wil  end  up  with  no  events  pending. 

(b)  when  a  new  final  value  event  is  scheduled  it  will  be  ignored  if 

(i)  there  is  a  pending  final  value  event  for  the  same  value  which  is  scheduled  to 
happen  at  an  earlier  time  than  the  new  event.  If  this  test  fails,  any  pending 
final  event  is  discarded,  and  the  remaining  conditions  checked. 

(ii)  there  is  a  pending  charge  sharing  event  for  the  same  value  as  the  new  final 
value  event. 

(iii)  there  is  no  charge  sharing  event  and  the  new  event  is  for  the  same  value  that 
the  node  currently  has. 

If  none  of  the  tests  are  successful,  the  new  final  value  event  is  added  to  the  event 
list. 

These  rules  are  based  on  the  observation  that  the  event  that  was  last  calculated  reflects  the  latest  net¬ 
work  configuration  and  hence  should  override  events  calculated  earlier.  Charge  sharing  events  throw 
away  final  value  events  since  the  charge  sharing  calculation  is  immediately  followed  by  a  new  final 
value  calculation. 

The  next  two  sections  describe  the  two  parts  of  the  simulation  computation. 

2.1.  Charge  sharing  eompatatlon 

This  portion  of  the  simulation  calculation  tries  to  model  various  capacitive  effects  that  happen 
when  two  (or  more)  previously  unconnected  nodes  become  connected.  For  example: 

0->  1 

± 

Qarge 

In  this  circuit  the  transfer  gate  has  just  turned  on,  connecting  a  bus  (represented  by  ,  initially  at 
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logic  low)  with  an  inverter  whose  output  is  a  logic  high.  If  Ciargi  and  the  pass  gate  are  large  enough, 
the  inverter  output  will  go  low  is  discharged)  initially,  but  eventually  both  the  inverter  output 

and  bus  will  go  to  a  logic  high.  In  RNL,  this  sequence  of  events  happens  in  two  steps:  a  charge  shar¬ 
ing  calculation  that  predicts  the  first  transition,  and  a  final  value  calculation  that  predicts  the  first 
transition,  and  a  final  value  calculation  that  predicts  the  ultimate  state. 

The  charge  sharing  computation  proceeds  as  follows: 

(1)  set  Cl  —  Cx  —  Ck  =  0; 

(2)  compute  connection  list:  starting  with  current  node,  include  all  nodes  in  the  net¬ 
work  that  can  be  reached  via  non-off  transistors  (includes  transitors  with  gates  with 
logic  state  *X*).  For  the  charge  sharing  calculation,  depletion  transistors  are  con¬ 
sidered  to  be  'off*  since  they  (usually)  represent  a  high  impedance  connection  over 
which  charge  sharing  would  happen  very  slowly. 

(3)  visiting  each  node  on  conection  list,  calculate  summary  capacitances  (Cl  ,Cx 
each  node  contributes  to  the  sum  corresponding  to  the  node’s  current  state).  Actu¬ 
ally  steps  (2)  and  (3)  can  be  merged  into  a  single  computation. 

(4)  compute  initial  state: 

1  CuKCl  +  Cjf  +C»)>V/yj* 

INITIAL  STATE  =  0  (C„  +  C,  )/(Ci  +  C*  +  C„)<V,^ 

.  X  otherwise 

For  each  node  on  the  connection  list,  schedule  a  transition  to  the  initial  state  with 
zero  delay  -  this  event  may  be  ignored  under  the  conditions  described  at  the  end  of 
the  previous  section. 

V^fk  is  the  logic  high  threshold  of  the  node,  V,„  the  logic  low  threshold;  these  can  be  set  separately 
for  each  node  or  one  can  use  the  default  setting  (see  NETLIST  and  PRESIM  documentation). 

Note  that  although  the  computation  could  be  made  node-by-node,  groups  of  electrically  con¬ 
nected  nodes  are  dealt  with  as  a  whole  since  their  events  are  obviously  related. 

2J.  Final  value  computation 

After  the  charge  sharing  calculation  is  done,  RNL  revisits  each  group  of  affected  nodes  to  compute 
their  final  values.  As  we  saw  in  the  example  of  the  previous  section,  a  node’s  ultimate  value  may 
differ  from  its  charge-sharing  value. 

The  final  value  computation  computes  two  peices  of  information  about  each  node. 

(1)  its  final  logic  state.  Recall  that  the  transistor  network  containing  the  node  is  being 
modeled  by  an  equivalent  resistor  network.  To  determine  the  logic  state  of  a  node, 
RNL  computes  the  Thevenin  equivalent  for  the  node  in  question  from  the  modeling 
resistor  network  (more  on  how  this  is  done  below)  ~  the  Thevenin  equivalent  vol¬ 
tage  is  used  to  calculate  the  final  logic  state  of  the  node. 

(2)  if  the  node  value  is  changing,  an  estimate  of  the  transistion  time  is  needed.  If  the 
transition  is  from  high  to  low,  RNL  computes  the  effective  resistance  to  GND  for 
the  node  (Rond)  then  calculates  the  trasnsition  time  as  Rqvo  ‘(capacitance  not 
already  at  GND).  A  similar  calculation  is  made  for  low  to  high  transitions.  Transi¬ 
tions  to  X  are  defined  to  take  the  same  time  as  the  shorter  of  the  high-to-low  and 
low-to-high  transitions. 

The  following  subsections  deal  with  each  part  of  the  final  value  computation. 
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23.  Network  anolysls 

This  section  outlines  how  the  Thevenin  equivalent  circuit  for  a  given  node  is  calculated  from  a 
larger  network.  We  start  by  describing  the  simple  transistor  model,  show  how  the  Thevenin 
equivalent  is  derived  using  information  about  each  transistor,  and  end  by  showing  how  the  new  value 
of  a  node  is  computed. 

The  transistor  model  in  RNL  can  be  quite  simple  since  it  is  only  used  to  predict  the  final  logic 
state  of  a  node  and  how  long  each  state  transition  takes.  Although  the  channel  resistances  of  the 
transistors  change  as  their  terminal  voltages  vary,  it  might  be  possible  to  use  'average  channel  resis¬ 
tances*  to  characterize  the  transistors’  behavior.  RNL  does  just  this  ~  transistors  arc  modeled  as  resis¬ 
tors  whose  resistances  are  determined  by  the  logic  state  of  the  transistor’s  terminal  nodes  and  the  type 
of  transistor: 

Rtransistor  =  (length/width)  *  type  *  state  where 

width,  length  are  the  dimensions  of  the  active  transistor  area. 

type  is  the  average  channel  resistance  per  unit  area  for  the  particular  type  of 

transistor. 

state  a  scale  factor  that  depends  on  the  logic  state  of  the  transistor’s  terminal 

nodes. 

The  following  table  shows  type'state  for  an  enhancement  transistor  (V,  is  the  logic  state  of  the  gate 
node). 


enhancement 


type  •  state 

0 

» 

1 

enh 

X 

[enh,  *  1 

where  enh  is  the  characteristic  channel  resistance  of  an  enhancement  device.  When  the  state  of  the 
gate  and/or  source  nodes  of  a  transistor  are  X,  the  resistance  of  the  transistor  is  also  'unknown*  and  is 
specified  by  an  interval. 

We  can  now  describe  how  V,/^  and  for  a  given  node  can  be  calculated  from  a  network  of 
nodes  and  transistors.  The  network  analysis  subroutine  does  a  tree  walk  of  the  network  returning  the 
values  of  the  two  resistors,  Rh  and  Ri ,  that  make  up  the  characteristic  voltage  divider  for  a  node: 


The  subroutine  is  outlined  below.  The  terms  'source*  and  'drain*  are  used  to  distinguish  between  the 
two  terminal  nodes  of  a  transistor  and  do  not  imply  anything  about  their  relative  potential. 

if  node  is  a  logic  low  input  { 
return  with  RH  =  *  and  RL  =  0+ 

)else  if  node  is  a  logic  high  input{ 
return  with  RH  >  0-t-  and  RL  >  • 
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}clse{ 

local_RH:  =  IocaI_RL  :  =  » 
mark  current  node 

for  each  'on'  transistor L.  with  source  connection  to  current  node{ 
if  drain  node  is  not  marked{ 
recursively  analyze  drain  node 

derive  a  voltage  divider  that  approximates  the  effect  of  the 
drain  node  on  the  current  node  (approximation  uses  RH  and  RL 
for  the  drain  node  and  the  equivalent  resistance  for  t) 
parallel  approximating  voltage  divider  with  local  RH  and  local_RL 

} 

} 

return  with  RH  =  local_RH  and  RL  =  locai_RL  ) 

Cycles  are  avoided  by  marking  each  node  as  it  is  visited:  this  keeps  the  tree  walk  expanding  outward 
from  the  starting  node.  If  the  network  does  contain  cycles,  the  subroutine  only  approximates  the  true 
resistance  to  VDD  and  GND.  For  example,  consider  the  following  gate  where  the  output  (the  pulled- 
up  node)  is  the  node  of  interest: 


In  the  circuit  on  the  left  the  pulldown  path  contains  a  cycle;  RNL  treats  the  cycle  u  if  the  circuit 
looked  as  shown  on  the  right.  This  approximation  avoids  having  to  solve  a  system  of  equations  at 
simulation  time;  fortunately,  very  few  networks  actually  contain  such  cycles.  It  is  dso  worth 
remembering  that  the  resistor  network  is  itself  only  an  approximation  -  it  is  not  worth  a  large  invest¬ 
ment  of  computation  time  to  calculate  an  exact  equivalent  to  the  resistor  network. 

The  final  state  of  a  node  can  be  characterized  by  a  voltage  source  with  a  series  resistor,  ije.,  the 
Thevenin  circuit  equivalent  for  all  pieces  of  the  network  that  influence  the  value  of  the  given  node. 


a  voltage  interval  [V  _,  V  4.]  in  the  range  [0,1]  specifying  the  possible  voltages  the  out¬ 
put  node  may  have. 

KfUgr  a  resistance  interval  [ff-,  X 4.]  in  the  range  [0-t-,  eo  ]. 

V,^  and  are,  in  general,  intervals  since  the  equivalent  transistor  resistances  from  which  they 
are  derived  might  themselves  lie  in  an  interval.  Using  the  values  returned  by  the  network  analysis 
subroutine,  we  have: 
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V.  = 


RL- 


RL.  +  JW4- 


and  V  4.  = 


RL^ 


RL^  +  JOT. 


Ra^  -  RL^  1 1  JW  4. 

Because  we  are  interested  only  in  the  worst  case  determination  of  the  voltage  level,  we  need  only  con¬ 
sider  the  worst  case  Thevenin  resistance.  As  will  be  seen  in  the  next  section,  the  final  value  is  directly 
related  to  V  _  and  V  4. 

Different  values  for  Rthev  lead  to  different  conclusions  about  the  state  of  the  node: 

input  (Rriin  -  0+).  Node  is  designated  input  node  (e.g.,  VDD  or  GND).  The  value  of  input 
nodes  can  only  be  changed  by  explicit  simulator  commands  -  the  assumption  is  that  they  supply 
enough  current  to  be  unaffected  by  connection  (even  shorts  to  other  inputs)  made  by  transistors, 
driven.  (0+  <  R,,^  <  «  ).  Node  is  part  of  a  voltage  divider  between  two  inputs,  i^.,  it  is  con¬ 
nected  by  transistors  to  other  driven  or  input  nodes.  As  will  be  seen  below,  the  logic  state  of  a 
driven  node  is  determined  by  Vthev.  charged  (Rn^  =<*>).  Node  is  connected,  if  at  all,  only  to 
other  charged  nodes.  Charged  nodes  will  maintain  their  current  logic  state  until  either  (1) 
reconnected  to  some  other  part  of  the  network,  or  (2)  a  user-specified  decay  interval  elapses  at 
which  time  logic  state  changes  to  X. 


2.4.  Cakolating  transition  delays 

Once  the  final  logic  state  of  a  node  has  been  determined  using  the  Thevenin  equivalents,  RNL 
calculates  transition  times  using  one  of  the  followig  characteristic  resistances  calculated  for  each  node: 

l^csD  effective  resistance  of  all  direct  paths  to  GND.  A  simple  serial/parallel  calcu¬ 

lation  is  used  to  determine  Rond- 

Rvdd  itie  effective  resistance  to  Rydd,  computed  in  a  similar  fashion. 

These  two  resistances  can  be  calculated  at  the  same  time  as  the  Thevenin  equivalents;  the  network 
analysis  routines  actually  return  four  values:  the  intervals  RL  and  RH,  and  the  values  RGND  and 
RVDD.  The  calculation  proceeds  as  follows: 

(1)  set  inputseen  =  false,  =  Cx  =  Ch  =  0; 

(2)  calculate  connection  list  and  summary  capacitances  (C^, ,  Cxt  C„:  each  node  contri¬ 
butes  to  the  sum  corresponding  to  the  node’s  current  state).  If  an  output  node  is 
reached  during  the  construction  of  the  connection  list,  set  inputseen  =  true. 

(3)  if  inputseen  is  false,  schedule  a  decay  transition  for  each  node  on  the  connection  list, 
then  exit. 


(4)  if  inputseen  is  true,  for  each  node  on  the  connection  list: 

(a)  if  node  is  an  input,  continue  with  next  node  on  list. 

(b)  calculate  (also  Reno  ^voo  to  be  used  later). 

(c)  compute  the  node’s  final  state: 

f  1  V  > 


FINAL  STATE  = 


0  V4<  Vto, 


I  ^  otherwise 

and  the  effective  capacitance  and  resistance 
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Cl  +  Cx  if  final  state  =  1 

Ctff  -  Ch  +  Cx  if  final  state  =  0 

min  (Cl  +Cx  +Cx)  otherwise 


^VDD  if  final  state  =  1 

Rcud  =  0 

nun  (Rcnd  »  ^vdo  )  otherwise 

(d)  schedule  a  transition  to  the  final  state  with  a  delay  of  R,ff  *C,ff  nanoseconds, 
or  use  user-specified  delay  if  present. 

Note  that  the  effective  capacitance,  C,f  /  ,  depends  on  the  summary  capacitances,  not  jtut  the  capaci¬ 
tance  of  the  node  in  question.  This  means  that  none  of  the  connected  nodes  will  reach  its  final  value 
much  before  the  others. 

2.5.  Calibrating  the  model 

The  charge  sharing  calculation  described  in  section  2.1  depends  only  on  the  capacitance  associ¬ 
ated  with  each  node.  These  capacitances  are  specified  by  the  designer  as  part  of  the  NETLIST 
description  or  in  the  PRESIM  parameter  file,  both  of  which  are  described  elsewhere  in  this  document. 

The  final  value  computation  uses  both  the  node  capacitances  and  resistance  information  about 
each  transistor.  The  circuit  data  base  contains  the  size  and  type  of  each  transistor  -  what  the 
designer  must  provide  in  addition  is  the  characteristic  resistance  for  each  type  of  channel  (i.e.,  the 
resistance  of  a  square  transistor  of  that  type).  See  the  description  of  the  set-params  subr  in  section  7.5 
for  how  this  information  is  specified  to  RNL. 

Actually,  RNL  uses  three  characteristic  resistances; 

a  static  resistance  used  in  calculating  RH  and  RL.  a  dynamic-low  resistance  used  in  calculating 
the  resistance  of  paths  to  GND.  a  dynamic-high  resistance  used  in  calculating  the  resistance  of 
paths  to  VDD. 

A  single  characteristic  resistance  won’t  suffice:  RNL  uses  resistances  to  determine  both  the  voltage 
level  and  transition  times  --  a  resistance  value  that  gives  an  accurate  estimate  of  the  voltage  level  may 
not  necessarily  result  in  good  transition  time  estimates.  Thus,  "static”  resistances  used  for  voltage 
level  calculations  can  be  specified  separately  from  "dynamic"  resistances  used  for  transition  time  calcu¬ 
lations. 

There  are  two  sets  of  dynamic  resistances:  dynamic-high  resistances  used  when  calculating  the 
resistance  of  paths  to  VDD,  and  dynamic-low  resistances  used  when  calculating  resistance  to  GND. 
Ordinarily,  these  are  set  to  the  same  value  for  a  particular  type  of  transistor;  some  useful  exceptions: 

(1)  setting  the  dynamic-low  resistances  very  high  for  devices  which  should  not  appear  in 
pulldown  paths.  The  very  high  transition  times  that  result  will  serve  to  flag  "strange” 
circuits. 

(2)  setting  the  dynamic-low  resistance  for  enhancement  devices  to  be  appropriate  for 
pulldowns,  while  setting  their  dynamic-high  resistance  to  be  correct  for  source- 
follower  configurations. 

(3)  since  pullups  are  treated  as  separate  types,  the  dynamic-high  resistance  for  deple¬ 
tion  devices  can  be  set  for  a  source-follower  configuration. 
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Future  versions  of  the  RNL  will  distinguish  between  different  circuit  contexts  for  the  same  type 
of  device:  e^.,  enhancement  devices  would  be  classed  as  ordinary,  pulldown,  source-follower,  transfer, 
etc.  Having  the  ability  to  set  separate  dynamic  resistances  for  a  transfer  device  (for  example)  means 
that  the  transition  times  for  high-going  and  low-going  transitions  involving  the  transfer  device  can  be 
much  more  accurate. 

The  static  resistances  can  be  estimated  from  measurements  (actual  or  SPICE’d)  of  the  low  thres¬ 
hold  for  standard  logic  gates  ••  there  is  considerable  flexibility  since  there  are  many  more  adjustable 
parameters  than  are  needed.  Dynamic  resistances  can  be  estimated  by  measuring  high-  and  low-going 
transition  times  of  standard  circuit  configurations  and  choosing  the  characteristic  resistances  to  give 
an  R-C  time  constant  equal  to  the  time  the  actual  waveform  takes  to  cross  the  desired  threshold. 

3.  RNL  CALIBRATION  VIA  THE  PRESIM  CONFIG  FILE 

Provided  here  is  a  brief  description  for  setting  the  parameters  in  the  presim  configuration  file. 
This  is  not  the  only  way  to  obtain  these  values  but  the  scheme  does  provide  some  consistancy  between 
analysis  models  like  those  used  in  SPICE.  Throughout  it  is  assumed  that  the  Presim  User’s  Guide  has 
been  consulted  and  is  available  for  parameter  names,  defaults  etc. 

3.1.  Capacitance 

There  are  three  basic  types  of  capacitance  values  that  can  be  set  by  the  use  of  the  configuration 
file. 

1)  Capacitance  from  the  area  of  the  node  interconnect.  This  case  breaks  down  into  3  subcases; 
metal  area  (1st  and  2nd  layers),  polysilicon  area  and  diffusion  area  (both  types  in  CMOS). 

2)  Capacitance  from  the  perimeter  of  the  node  interconnect.  Parameters  for  all  layers  are  provided 
by  presim. 

3)  Capacitance  from  the  area  of  the  gate  regions  of  a  node. 

All  capacitance  is  assumed  grounded. 

3.1.1.  Area  Capacitance 

In  NMOS  the  diffusion  area  capacitance  can  be  estimated  as  directly  proportional  to  the  SPICE 
model  parameter  Cj  with  proportionality  constant  K^q  ■  For  abrupt  junctions  (a  good  approximation 
considering)  K^q  is  given  by, 

^£0  =  2-^^(v^+v^-V^+vT). 

V2-V1 

V1-V2  is  the  voltage  range  and  can  be  assumed  rail  to  rail.  One  must  also  be  careful  that  the  units 
are  correct  for  presim  (presim:  pf/micron,  SPICE:  F/m).  For  a  complete  discussion  of  this  approxima¬ 
tion  see  "Analysis  and  Design  of  Digital  Integrated  Circuits,"  D.  A.  Hodges  and  H.  G.  Jackson, 
McGraw-Hill  Book  Co.,  New  York,  p.  137. 

Similarly  in  CMOS,  one  uses  the  Cy  for  the  two  types  of  diffusion  n'*’  and  p*.  The  contribution 
of  metal  and  polysilicon  areas  can  be  assumed  to  be  an  order  of  magnitude  smaller  that  diffusion.  As 
of  yet  we  have  no  experience  with  second  layers  of  poly  and  metal. 

3.U.  Perimeter  Cepaeltence 

For  the  diffusion  perimeter  contributions  one  uses  the  values  for  CJSW  provided  in  the  SPICE 
models.  Warning,  get  the  units  (presim:  pf/micron,  SPICE:  F/m)  correct! 

3.1.3.  Gate  Capacitance 

Gate  capacitance  can  be  estimated  from  ratio  of  the  silicon  permittivity  and  the  oxide  thickness 
times  the  area  of  the  active  gate. 
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Again  one  must  be  aware  to  the  difference  in  the  units  used  in  presim  and  SPICE. 


3.2.  Resistance  values 

Establishing  the  resistance  values  is  much  more  complicated.  As  the  circuit  elements  (e.g.  static 
logic,  plas  etc.)  have  a  direct  bearing  on  the  representation  of  transistors  by  the  resistors  RjyHiow  tmd 

In  most  cases  it  is  sufficient  to  perform  circuit  analysis  on  single  transistors  charging  a  fixed 
capacitive  load.  Two  examples  that  should  be  included  in  any  suite  are  shown  below. 


5V 


The  type  of  transistor  used  in  these  experiments  would  vary  from  depletion,  p  type  enhancements  or  n 
type  enhancements.  Of  course  the  gate  voltages  and  must  be  adjusted  for  these  various  transistor 
types. 

The  resistance  value  is  defined  then  as. 


This  is  in  effect  inverting  the  calculation  done  by  RNL.  The  R  values  can  be  computed  for  the  all 
types  and  the  typical  sizes  (length  and  width)  of  transistors  used  in  the  circuits  to  be  simulated  by 
RNL.  This  should  be  streesed,  the  table  maintained  by  presim  is  indexed  by  type  and  the  length  and 

width  independently  not  by  the  ratio 

Interestingly  as  a  practical  matter  using  the  above  definition  for  the  resistance  includes  some  of 
the  effect  of  the  volatage  dependent  capacitance.  This  can  be  represented  by  the  writing  ht  as 


From  this  the  ratio 
capacitance. 


^  )flarailrte 


'lead 


—  R  {pumi  )|MraiMc ). 

is  the  contribution  to  the  resistance  R  from  the  voltage  dependent 


4.  SOME  OBSERVATIONS  ON  THE  LIMITATIONS  OF  RNL’S  CIRCUIT  MODEL 
We  begin  this  section  quoting  from  the  original  User’s  Guide  by  C.  Terman. 

It  should  be  remembered  that  the  programs  are  based  on  a  model  of  what  actually  happens.  As  with 
any  model,  there  are  likely  to  be  discrepancies  between  the  predictions  of  the  model  and  what  actu¬ 
ally  happens.  The  tools  described  here  try  hard  to  be  conservative,  ia.  give  a  pessimistic  prediction 
—  but  this  can’t  be  guaranteed.  Thus,  it’s  wise  to  acquaint  oneself  with  how  the  models  work  and 
where  their  shortcomings  lie;  think  of  the  tools  as  performing  a  calculation  you  could  do  by  hand 
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(only  a  lot  faster  and  with  greater  accuracy  and  consistency);  for  your  own  protection,  don’t  treat  the 
tools  as  black  boxes. 

With  this  warning  in  mind  it  will  be  assumed  that  the  reader  has  acquainted  themselves  with  the 
model.  The  basics  are  provided  in  the  Theory  of  Operation  section  of  this  user’s  guide. 

As  a  practical  matter  RNL  provides  sufficient  parameters  for  nodes  and  circuit  elements  to 
reproduce  the  overall  behavior  obtained  from  other  more  elaborate  circuit  analysis  tools.  However,  it 
should  be  remembered  that  as  the  designer  pushes  the  tolerances  no  simulation  may  reflect  the  physi¬ 
cal  device. 

4.1.  Propagatton  of  X  States 

The  main  considerations  for  X  state  evaluation  are; 

1)  Initial -resistance  values  (Rcsd  Rvee)  for  charging  and  discharging  the  capacitive  load  are 
assumed  infinite. 

2)  In  evaluating  a  network  stage,  transistors  that  are  gated  by  nodes  in  state  X  are  assumed  to  have 
a  resistance  represented  by  an  interval  and  do  not  terminate  the  stage  evaluation.  This  interval 
is  included  only  in  the  Tlievenin  state  evaluation  and  not  in  the  resistance  values  used  for 
estimating  the  delay  times. 

3)  Recalling  that  an  explicit  estimate  of  transition  times  to  the  X  state  are  not  made.  The  transi¬ 
tion  time  is  defined  to  be  the  minimum  of  [tplh,  tphl]. 

There  are  two  quite  different  interpretations  of  X  states.  One  is  to  consider  it  as  some  intermediate 
voltage,  say  2SV.  This  is  inconsistent  with  condition  2)  because  some  contribution  to  the  delay  time 
would  be  made  with  this  as  the  gate  voltage.  Within  the  RNL  model,  X  is  best  considered  as  an 
undefined  voltage.  Condition  2)  is  then  a  very  conservative  statement  of  what  these  undefined  nodes 
contribute  to  delay  times. 

4.1.1.  NMOS  and  CMOS  tnverten 

The  effects  of  these  conditions  are  highlighted  by  the  propagation  of  an  X  state  through  NMOS 
and  CMOS  inverters.  In  both  cases  the  state  calculation  reaches  the  correct  answer  that  the  output 
should  also  make  a  transition  to  X.  The  transition  times  for  the  two  cases  are  now  considered 
separately. 

*  For  a  NMOS  inverter  the  transition  time  to  logic  H  is  independent  of  the  inverter  input  (i.e.  it 
uses  a  depletion  pullup)  and  it  reports  this  as  the  transition  time  Ryjj  . 

*  In  the  CMOS  case  however,  both  logic  H  and  logic  L  transition  times  depend  upon  the  inverter 
input.  Then  from  condition  2),  in  CMOS  no  contributions  are  made  to  lower  the  transition  time 
from  infinity.  This  leads  to  a  rather  unrealistic  estimate  for  the  delay  time  on  the  output. 

On  a  node  by  node  basis  RNL  does  provide  the  capability  to  override  the  RC  time  constant.  By 
explicitly  setting  the  rise  and  fall  times  for  a  node,  transitions  to  X  are  propagated  with  minimum  of 
the  two  values.  By  its  nature  this  solution  removes  one  of  the  attractive  features  of  RNL,  the 
dynamic  evaluation  of  signal  delay  times.  Moreover,  in  the  cases  where  there  are  more  inputs  to  the 
output  node  (eg.  a  nand)  this  effect  can  be  difficult  to  track  down.  Let  a  word  to  the  wise  be 
sufficient. 

4J.  Node  Overdrive 

Important  considerations  for  the  following  discussion; 

1)  The  replacement  of  transistors  with  resistors  is  independent  of  the  logic  thresholds  declared  for 
the  transistor  terminals. 

2)  Node  states  are  determined  by  comparison  of  Thevenin  resistance  ratios  with  node  logic  values 
V,^  and 

When  two  (or  more)  charging  elements  are  driving  a  single  node,  accurate  modeling  of  node 
overdrive  guarantees  the  right  element  wins.  Node  overdrive  is  used  more  frequently  in  CMOS  design 
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and  should  be  of  particular  interest  to  those  designers.  Using  this  property  in  a  digital  circuit  intro¬ 
duces  significant  dependence  on  analog  properties  of  the  circuit  elements  and  nodes.  In  such  cases  it 
is  suggested  that  an  analysis  tool  such  as  SPICE  be  used  to  characterize  the  behavior  of  the  subcircuit. 
With  the  SPICE  results  one  can  use  several  equivalent  approaches  to  modeling  the  subcircuit  with 
RNL.  The  following  approach  is  trail  and  mot  but  does  not  require  that  the  device  sizes  be  changed 
from  those  analyzed  by  SPICE. 

From  the  theory  of  operation  section  of  this  user's  guide  recall  that  the  final  state  of  a  node  is 
determined  by  comparison  of  the  Thevenin  resistance  ratios  to  parameters  and  Further¬ 

more,  these  parameters  can  also  be  set  on  a  node  by  node  basis.  Values  can  then  be  found  that  repro¬ 
duce  the  SPICE  behavior  for  the  node  of  interest.  Depending  upon  the  translation  from  transistors  to 
resistors,  the  range  Vta»  to  Vugh  can  be  quite  narrow.  Again  success  of  any  of  these  methods  depends 
on  the  tolerances  in  the  design  and  all  can  be  made  to  fail. 

42.1.  Memory  cell 

An  example  of  node  overdrive  that  is  commonly  found  in  NMOS  and  CMOS  designs  is  the  6 
transistor  memory  cell.  Only  the  CMOS  example  is  shown  here  but  the  technique  presented  here 
works  equally  well  for  the  analogous  NMOS  design. 


M 

M 

5 

We  include  from  Hodges  and  Jackson  (  Analysis  and  Design  of  Digital  Integrated  Circuits,”  D. 
A.  Hodges  and  H.  G.  Jackson,  McGraw-Hill  Book  Co.,  New  York,  p.  380.)  a  discussion  on  the  sizing 
of  the  transistors  in  such  a  memory  cell. 

To  read  a  I,  D  and  Dbar  are  initially  biased  at  about  JV.  When  the  cell  is  selected,  current  flows 
through  A#4  and  A#2  to  ground  and  through  Ms  and  Ms  to  D.  The  gate  voltage  of  Ms  does  not  fall 
below  JV,  so  it  remains  on.  However,  to  avoid  altering  the  state  of  the  cell  when  reading,  the  con¬ 
ductance  of  Ms  must  be  about  three  times  that  of  Mg  so  that  the  drain  voltage  of  Ms  does  not  rise 
above  Vj .  The  operations  of  writing  and  reading  a  0  are  complementary  to  those  just  described. 

Such  conservative  design  style  should  provide  the  designer  with  a  working  circuit  without  appeal  to 
detailed  analysis.  Optimization,  however,  of  the  memory  cell  would  be  difficult  to  accomplish  with 
RNL. 

Simulating  circuits  of  this  type  brings  into  focus  an  important  conceptual  difference  between 
RNL  and  analysis  tools.  In  RNL  the  logic  threshold  voltages  Vtg„  and  are  declared  indepen¬ 
dently  from  the  replacement  of  transistors  with  resstors.  In  the  memory  cell  this  independence  means 
that  RNL  could  find  transistor  sizes  that  predict  correct  behavior  for  any  set  logic  threshold  voltages. 
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Design  of  the  6  transistor  memory  is  by  no  means  the  only  case  where  the  independence  of  the  logic 
thresholds  and  transistor  replacement  can  provide  misleading  results.  As  a  rule  subcircuits  with  ana¬ 
log  properties  should  be  analyzed  using  other  tools  first  and  then  RNL  parameterized  to  fit  that 
behavior. 

4J.  Floating  Nodca 

Important  considerations  for  this  discussion  are; 

1)  The  effects  of  a  charge  sharing  event  are  evaluated  immediately. 

2)  Only  one  charge  sharing  and  one  final  state  event  can  be  pending  for  each  node  in  the  circuit. 

Floating  nodes  present  another  case  where  the  analog  properties  dominate  the  prediction  of  the 
behavior  of  the  subcircuit.  In  many  cases  a  floating  node  can  have  several  inputs  making  it  difficult  to 
find  a  set  of  RNL  parameters  for  the  nodes  involved.  The  following  example  demonstrates  these 
difficulties. 

43.1.  Exclnstvc  or 

This  is  a  CMOS  design  of  an  exclusive  or  where  all  transistors  can  be  of  minimum  size.  It 
requires  the  transmission  gate  (TG)  to  compensate  for  the  poor  transmission  of  a  logic  low  by  a  p  type 
enhancement  and  conversely  logic  high  by  a  n  type  enhancement. 


Initially  it  was  thought  that  oat  would  require  the  most  attention  in  the  parameterization.  Naive 
RNL  simulation  provided  reasonable  predictions  for  the  cases  where  TG  contributed  to  the  final  state 
of  oat.  The  states  that  utilize  the  TG  are  indicated  in  the  state  table  below.  RNL  did  not  predict 
proper  behavior  in  other  cases.  For  example,  when  b  was  high  and  a  changes  from  low  to  high,  oat 
was  predicted  to  be  X.  This  was  not  the  result  of  SPICE  analysis.  It  was  also  found  that  correct 
predictions  for  the  other  states  could  only  be  obtained  when  nodes  a  and  b  were  set  at  the  same  time 
in  the  simulation.  Another  alternative  was  to  declare  abar  as  an  input.  This  evidence  suggests  that 
the  other  nodes  (e.g.  a,  abar,  b)  should  be  the  focus.  Why? 
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In  the  first  case  the  simultaneous  transition  of  a  and  b  produce  the  proper  final  state  because  the 
result  of  charge  sharing  is  the  correct  final  state.  Secondly,  declaring  any  node  an  input  (in  this  case 
abar)  provides  it  with  zero  impedance  for  that  state.  For  the  duration  of  it  being  an  input,  this 
excludes  any  possible  state  changes  including  the  offending  charge  sharing  event. 

The  difficulty  in  simulating  this  circuit  with  RNL  centers  around  the  fact  that  the  node  oat  is 
controlled  by  the  nodes  that  are  also  its  inputs,  namely  a  and  abar.  Transitions  of  either  node  can 
promote  the  scheduling  of  both  charge  sharing  and  final  state  transistions.  The  effects  of  the  charge 
sharing  event  are  by  design  evaluated  immediately.  Without  careful  consideration  of  the  and 
Vu$k  for  the  nodes  a  and  abar,  the  charge  sharing  events  can  result  in  a  final  state  of  X  for  node  oat. 
The  correct  final  state  for  ont  is  then  discarded  by  RNL  (only  one  charge  sharing  and  final  state 
change  can  be  pending)  and  is  replaced  by  a  transition  to  X. 

Sommary 

From  the  examples  presented  RNL,  used  with  some  care,  does  have  the  ability  to  reproduce 
many  of  the  results  obtained  from  other  analysis  tools.  Due  to  the  independence  of  transistor  replace¬ 
ment  and  node  logic  voltages  detailed  analysis  of  subcircuits  should  be  done  when  analog  properties 
dominate  the  subcircuits  behavior. 

4.4.  Probicnu  With  Circalt  InltlaUzation. 

The  functions  stm-lnlt  and  swttch-lnit  operate  by  walking  through  the  network  and  for  each 
node  that  is  in  the  X  state  scheduling  on  the  event  queue  an  immediate  transition  of  that  node  to  the 
0  state.  A  subsequent  advancement  of  the  simulated  time  will  allow  these  transitions  to  occur  and 
their  effects  to  propagate.  This  is  especially  useful  in  circuits  that  contain  storage  elements  that  can¬ 
not  be  controlled  by  the  inputs  to  the  circuit.  A  typical  example  is  a  divider  circuit  composed  of  a 
chain  of  latches  and  whose  only  input  is  a  clock  line.  Because  RNL  interprets  X  as  the  'unknown' 
rather  than  as  the  'intermediate”  state,  a  flip-flop  which  contains  X’s  will  remain  'unkno'-n'  rather 
than  go  through  a  transition  from  a  meta-stable  to  a  well-defined  state.  (Circuit  ananysis  simulators 
such  as  SPICE  have  their  own  problems  when  it  comes  to  resolving  mets-stable  states.) 

While  it  is  sometimes  necessary  to  use  dm-lnlt  or  swKcb-Inlt,  there  are  cases  in  which  these  func¬ 
tions  will  be  unreasonably  expensive,  taking  hours  or  even  days  to  initialize  the  circuit.  This  is  espe¬ 
cially  true  if  stm-taiit  is  called  before  any  other  attempts  are  made  to  initialize  the  circuit,  lliis 
phenomenon  has  two  realted  causes: 

Slm-inlt  schedules  its  (nominally  simultaneous)  transitions  in  the  order  that  it  finds  the  nodes  in 
the  node  hash  table.  This  is  in  contrast  to  scheduling  nodes  closer  to  inputs  first,  or  other 
related  schemes.  This  can  result  in  a  lot  of  extra  events  being  scheduled  and  evaluated.  A  typi¬ 
cal  example  is  when  an  output  of  a  NOR  gate  is  initialized  before  its  inputs.  The  effects  of  the 
output  being  in  a  0  state  are  computed  and  propagated  even  though  the  evaluation  of  the  inputs 
will  eventually  put  the  output  in  a  1  state. 

The  evaluation  of  events  during  initialization  can  be  very,  very  expensive  compared  to  compar¬ 
able  events  during  the  normal  operation  of  the  circuit.  Tlie  reason  for  this  is  again  the 
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interpretation  of  the  X  state.  When  RNL  attempts  to  evaluate  the  effeets  of  an  event  on  some 
node  A,  it  examines  the  states  of  all  the  other  nodes  connected  to  A.  Since  the  interpretation  of 
X  is  'unknown',  a  transistor  whose  gate  is  X  might  be  on.  If  A  is  the  source  or  drain  of  that 
transistor  then  it  might  affect  the  final  state  of  A  and  therefore  the  computation  must  consider 
this.  If  the  node  A  happens  to  be  affected  by  many  transistors  (consider  one  line  in  a  bus),  and 
if  the  control  lines  gating  those  transistors  are  in  state  X,  then  each  time  any  of  the  nodes  con¬ 
nected  to  the  bus  through  one  of  these  'maybe  on'  transistors  goes  through  a  transition  all  of  the 
nodes  will  be  examined.  This  is  exactly  what  ha|^ns  when  stm-InU  is  invoked  before  the  con¬ 
trol  lines  are  initialized.  Eventually  the  control  lines  may  be  initialized,  but  by  then  the  damage 
has  been  done. 

The  moral  is  that  one  should  be  careful  when  one  attempts  to  initialize  a  circuit  in  RNL.  Good 
design  practice  dictates  that  for  testability  purposes  it  should  be  easy  and  efficient  to  put  a  circuit  into 
some  known  state  by  driving  its  inputs.  One  should  attempt  to  use  that  initialization  protocol  to  ini¬ 
tialize  simulated  circuits  also.  The  cases  in  which  this  does  not  seem  to  work  are  those  in  which  there 
are  embedded  state  machines  that  must  already  be  in  a  well-defined  state  before  they  can  be  initial¬ 
ized.  If  the  outputs  of  these  sub-circuits  control  large  parts  of  the  chip  then  a  special  initialization 
protocol  for  these  parts  should  be  considered.  Only  after  one  has  initialized  what  can  be  controlled 
from  inputs  and  only  after  one  has  eliminated  the  X’s  on  the  major  control  lines  of  the  circuit  should 
one  consider  using  stm-step  to  do  the  residual  initialization. 

5.  USER  INTERFACE 

The  user  interface  of  RNL  is  a  simple  LISP  interpreter.  This  is  a  brief  introduction  to  that  ver¬ 
sion  of  LISP. 

The  interpreter  continually  executes  the  following  loop: 

(1)  read  a  command  from  current  input; 

(2)  evaluate  the  command,  performing  the  specified  actions; 

(3)  print  the  result  and  loop  back  to  (1). 

There  are  two  syntactic  forms  for  specifying  commands  to  this  loop.  The  most  general  looks  like 
(function  argument  argument  ...  argument) 

ic.,  a  list  of  names,  numbers,  etc.  separated  by  white  space  (spaces,  tabs,  and  newlines)  and  enclosed 
in  parentheses.  The  parentheses  delimit  the  command,  so  that  the  white  space  can  be  used  to  format 
the  input  any  way  one  pleases.  The  arguments  themselves  may  also  be  of  the  form  (function  arg  ... 
arg).  The  interpreter  first  reads  the  entire  command  ~  up  to  the  closing  parenthesis.  The  first  ele¬ 
ment  of  the  list  is  interpreted  as  a  function.  The  arguments  are  then  evaluated  in  left-to-right  order 
and  the  results  passed  to  the  function.  The  value  returned  by  the  function  is  printed  and  the  reader 
invoked  once  again.  For  example,  given  the  following  input 

(•  17  (^-  3  2) 

(/  10  2)) 

RNL  would  respond  by  typing  42S  and  then  wait  for  more  input.  Note  that  nothing  happened  after 
the  first  newline  since  the  first  parenthesis  had  not  yet  been  closed. 

The  reader  for  the  command  interpreter  also  accepts  commands  of  the  form: 

function  argument  argument ...  argument  <  newline> 

This  is  equivalent  to 

(function  ’(argument  argument  ...  argument)) 

The  "'  is  shorthand  for  the  quota  special  form.  Tliis  keeps  its  argument  from  being  evaluated.  Quote 
is  explained  in  more  detail  below.  Many  of  the  simple  simulator  functions  contained  in  the  file 
'uwsimJ'  are  written  this  way  in  order  to  eliminate  the  typing  of  parentheses  when  invoking  common 
commands. 
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Comments  can  be  included  by  preceding  them  with  a  semicolon  (*;').  All  characters  following 
the  up  through  the  next  newline  are  ignored. 

5.1.  Objects  and  Valncs 

The  RNL  LISP  interpreter  allows  you  to  access  the  following  types  of  objects: 
numbers  -  signed  integers.  (16  bits  on  PDPlls,  24  bits  on  VAXen.  28  bits  on  PDPlOs). 

-  floating  point,  (the  standard  single  precision  format  for  the  machine. 

strings  sequence  of  characters  enclosed  in  quotes  (*).  Useful  as  constants  for  file  names, 

print  statements,  etc.  Special  characters  can  be  introduced  into  the  strings  by  using 
the  backslash  escapes: 

‘\n  ’  newline 
‘\r  ’return 
•\t’tab 

‘\ooo  *  ascii  code  ”ooo*  where  ooo  are  octal  digits 

are  like  variables  in  other  programming  languages.  A  symbol  is  referred  to  by  its 
print  name:  any  sequence  of  characters  (not  including  a  period  V)  delimited  by 
'white  space*  that  isn’t  a  number  or  string.  Special  symbols  (including  white  space 
and  control  characters)  can  be  included  in  symbol  names  by  using  the  backdash 
escape  convention.  Long  symbol  names  with  embedded  blanks  and  all  other  special 
characters  can  be  created  by  enclosing  the  name  in  a  pair  of  vertical  bars. 

Example:  I  long  symbol \014  name  I  defines  a 

long  name  with  a  form  feed  in  the  middle.  Use  long  symbols  in  preference  to  strings. 

are  the  electrical  nodes  of  your  circuit.  Although  they  may  have  names  that  resemble 
symbols,  they  are  a  distinct  data  type.  Note  that  many  nt^es  have  print  names  that 
are  numbers.  Symbols  and  numbers  are  distinguished  from  nodes  by  the  context  in 
which  they  are  used.  In  addition  to  numbers  and  symbols,  nodes  can  have  structured 
names  of  the  form  'a.bx.  where  each  of  a  is  a  qrmbol  and  b,  c,  etc  are  symbols  or 
numbers.  This  allows  you  to  create  arrays  and  hierarchical  naming  schemes  for  your 
nodes.  It  has  the  unfortunate  side  effect  of  forcing  you  to  use  the  vertical  bar  con¬ 
vention  to  enter  s)rmboI  names  containing  periods,  i.e.  Ia.b£l. 

are  sequences  of  objects  enclosed  in  parentheses.  Standard  LISP  syntax  applies, 
including  dot  notation.  The  empty  list  *()*  is  also  called  'nil*. 

primitive,  or  built-in,  functions  (like  +). 

One  can  evaluate  an  object  for  a  value;  numbers,  strings,  subrs,  and  nodes  are  'self-evaluating*, 
ix.,  the  object  and  its  value  are  one  and  the  same. 

Evaluating  a  symbol  )rields  the  value  last  assigned  to  that  symbol  by  the  user  (see  the  setq  func¬ 
tion).  Symbols  actually  have  two  distinct  values:  the  value  used  during  evaluation  and  one  used  only 
when  the  symbol  is  us^  as  a  function  name.  A  useful  example  of  this  is  the  symbol  **”  which  when 
used  as  a  function  denotes  multiplication,  but  which  when  used  as  an  argument  denotes  the  last  value 
returned  by  a  command  to  the  top  level  interpreter. 

Evaluating  a  list  is  like  making  a  function  call.  The  functicn  value  (or  the  ordinary  value  if 
there  is  no  function  value)  of  the  first  element  of  the  list  is  the  function.  The  values  of  the  remaining 
list  elements  are  the  arguments.  For  example,  evaluating 

(■»-a3) 

looks  up  the  function  value  of  the  '+*  symbol  (in  this  case  it  will  be  the  subr  for  addition),  then  calls 


symbols 


nodes 


lists 

subrs 
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the  function  with  the  values  (recursively  computed)  of  *a*  and  *3*.  The  value  of  the  list  will  be  the 
value  returned  by  the  function. 

Certain  lists  have  ^>ecial  meaning  to  the  system  and  are  called  special  forms.  Two  q>ecial  forms 
of  particular  interest  are  discussed  here,  the  remainder  are  described  in  a  later  section.  The  quote 
special  form, 

(quote  arg)  or  ’arg 

allows  us  to  create  symbol  and  list  constants.  Thus  the  value  of  (quote  a)  is  the  symbol  'a',  and  the 
value  of  ’('*'  2  3)  is  a  list  of  three  elements. 

User  defined  functions  are  represented  by  the  lambda  special  form: 

(lambda  (param  param  ...)  exp  exp  ...) 

The  symbol  "lambda*  indicates  that  this  list  is  actually  a  user  function.  It  is  followed  by  a  list  giving 
the  names  of  the  arguments  and  finally  by  a  sequence  of  expressions  which  make  up  the  body  of  the 
function.  The  value  returned  by  the  function  when  called  will  be  the  value  of  the  last  expression  in 
the  body.  For  example, 

((lambda  (x)  (->-  x  3))  4) 

evaluates  to  7.  We  can  give  this  function  a  name  by  making  the  lambda  expression  the  value  of  some 
symbol: 

(setq  plus-3  ’(lambda  (x)  (-<-  x  3))) 

(plus-3  4) 

also  evaluates  to  7.  In  doing  this  we  set  the  ordinary  value  of  plus-3  to  the  lambda  expression.  A 
better  way  of  doing  this  is  to  use 

(defun  plus-3  (x)  (+  x  3)) 

which  makes  (lambda  (x)  (+  x  3))  the  function  definition  of  the  symbol  "plus-3*. 

Note  that  setq  changes  the  "expression  value*  of  a  symbol,  while  defun  changes  the  "function 
value*  -  this  distinction  is  unimportant  in  most  applications,  but  is  useful  if  you  wish  to  change  the 
definition  of  a  built-in  function  (beware  of  the  implications  before  trying  to  change  built-in  function 
definitions  though!). 

This  version  of  rnl  is  case  sensitive.  Special  nodes  with  names  "Vdd*  and  "VDIX  are  aliased  to 
"vdd";  "Gnd*  and  "GND*  are  aliases  of  "gnd*. 

52.  About  Efficiency 

LISP  symbols  and  circuit  nodes  with  the  same  name  are  in  fact  different  objects.  Functions  that 
take  nodes  as  arguments  also  work  with  LISP  sjnnbols,  but  the  symbol  is  converted  to  a  node  each 
time  the  function  is  called.  This  entails  getting  the  print  name  of  the  the  symbol  and  using  it  as  the 
key  in  a  hash  table  lookup  of  the  node.  While  this  is  implemented  efficiently,  it  is  still  much  more 
expensive  than  using  the  node  directly.  Often  used  arguments  should  therefore  be  converted  from 
symbols  to  nodes  using  Rud-node.  (This  conversion  can  be  done  only  after  the  network  has  been 
loaded  because  the  nodes  are  not  created  until  then.) 

52.  Useful  Symbols 

The  following  symbols  are  defined  by  RNL  and  are  accessible  to  the  user.  They  arc  useful  in 
writing  your  simulations. 

*  is  the  value  last  returned  by  the  top  level  loop.  This  is  mostly  useful  when  you  are 

poking  around  interactively. 

base  controls  the  radix  for  printing  integers.  If  not  one  of  2,  8,  10,  or  16  then  base  10  is 

used.  The  input  radix  is  controlled  by  using  the  Unix  conventions  extended  by  using 
"OB"  to  signal  a  binary  integer. 

current-time  is  the  current  value  of  simulated  time,  expressed  in  tenths  of  nanoseconds. 
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end-of-file  returned  when  EOF  is  read. 

event-list-empty  is  set  to  t  when  there  are  no  pending  electrical  events  on  the  queue,  nil  otherwise. 

user-intemipt  is  set  to  t  if  the  user  types  the  'quit'  character.  (Default  is  ctrl-\.)  A  check  for 
oaer-lnterrnpt  as  a  condition  for  exiting  a  time  consuming  loop  is  often  useful. 

€.  BUILT-IN  FUNCTIONS 

The  file  'uwstd.!'  contains  functions  that  are  usually  found  in  LISP  environments.  This  section 
documents  these  functions  in  addition  to  the  functions  that  are  really  built  in  to  RNL.  The  functions 
are  grouped  by  application  area.  The  areas  are: 

arithmetic  functions  and  predicates 
list  and  symbol  manipulation  functions 
i/o  functions 
special  forms 

network/simulation  functions 

Unless  otherwise  stated  all  functions  evaluate  their  arguments.  In  addition  to  standard  functions 
described  in  this  section,  you  have  the  option  of  loading  the  file  'uwsimJ'  which  contains  a  suite  of 
functions  that  implement  a  collection  of  useful  and  relatively  easy  to  use  'front-end'  facilities  for 
doing  circuit  simulations. 

The  notation  used  in  the  descriptions  of  the  functions  is  intended  to  make  clear  the  types  of  the 
arguments.  Arguments  are  prefixed  as  follows: 

g_  for  any  type, 
i_  for  a  symbol, 
t_  for  a  string, 

p_  for  types  with  unique  print  names  (symbob,  nodes,  strings,  and  integers), 
e_  for  symbob  and  nodes, 
i_  for  Ibt  arguments, 
n_  for  any  number, 
i_  for  integer, 

/_  for  floating  point. 

Quoting  the  formal  parameter  means  that  the  argument  evaluates  to  the  required  type.  Special 
types  are  mentioned  explicitly.  For  example  (fuac  ’ijwg)  means  that  ijtrg  evaluates  to  an  integer  and 
(  fuac  ’vec)  means  that  foac  takes  an  argument  that  evaluates  to  a  circuit  node  vector. 

6.1.  Arithmetic  faactloas 

Unless  otherwise  stated,  the  arithmetic  functions  take  both  floating  point  and  integer  arguments, 
returning  a  floating  point  result  if  any  argument  was  a  floating  point  number.  Warning:  overflow 
and  underflow  are  not  checked  by  these  functions. 

(  •  'njtrgl  .  . .  'njtrgn  ) 
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returns  the  product  of  its  arguments.  , 

(  +  'njtrgi  .  . .  ’njtrgn  ) 

returns  the  sum  of  its  arguments. 

(  -  'n_argl  . .  .  'njirgn  ) 

returns  the  first  argument  minus  the  sum  of  the  remaining  ones.  The  form  (  •  njarg  )  returns 
the  negation  of  its  argument. 

(  /  'njargi  'n_arg2  ’n_arg3  . .  .  ) 

returns  the  quotient  of  n_argl  divided  by  the  product  of  the  rest  of  the  arguments.  If  all  argu¬ 
ments  are  integers  the  result  is  an  integer  truncated  towards  zero. 

I 

(  %  'ijwgl  ’i_arg2  )  returns  the  remainder  of  Ijurgl  divided  by  i_arg2. 

(  1+  ) 

like  (->-  ’i_arg  1)  but  restricted  to  integers. 

(  1-  'ijurg  ) 

like  (•  *i_arg  1)  but  restricted  to  integers. 

(  <  'njargl  ’n_arg2  ) 

returns  t  if  a_argl  less  than  n_arg2. 

(  <  =  'njargl  'njirg2  ) 

returns  t  if  n_argl  less  than  or  equal  to  n_arg2. 

(  ==  'njirgl  ’njarg2  ) 

returns  t  if  n_argl  (numerically)  equal  to  n_arg2. 

(  !=  'njirgl  ’njirg2  ) 

returns  t  if  n_argl  (numerically)  not  equal  to  a_arg2. 

(  >  'njargl  'njirg2  ) 

returns  t  if  n_argl  greater  than  n_arg2. 

(  >  =  'njargl  'njirg2  ) 

returns  ( if  n_argl  greater  than  or  equal  to  n_arg2. 

(  abs  'n_arg  ) 

returns  the  absolute  value  of  njorg. 

(  ria  'njirg  ) 

returns  integer  part  of  njarg, 
truncated  towards  zero. 
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(  float  'njarg  ) 

returns  floating  point  version  of  n_arg. 

(  max  ’ijargt  .  .  .  ’ijargn  ) 

returns  maximum  of  its  (integer  arguments. 

(  mlB  'ijtrgl  . .  .  'ijargn  ) 

returns  minimum  of  its  (integer)  arguments. 

(  namberp  'gjirg  ) 

returns  t  if  g_arg  is  a  integer,  nil  otherwise. 

Fanctlons  and  Predicates  for  List  and  Symbol  Manlpnlatlon 
(  alphalesqi  'pjirgl  'p_arg2  ) 

returns  t  if  p_arg' s  print  name  is  lexicographically  less  than  pjarg2' s. 

(  append  'Ijorgl  'l_arg2  ) 

returns  list  of  Ijargl  with  l_arg2  appended  to  it.  (This  is  defined  in  'uwstdJ*.) 

(  atom  'gjarg  ) 

returns  t  if  gjirg  is  not  a  list. 

( 'Ij*'/  ) 

returns  first  element  of  list  Ijvg. 

(  edr  'Ijorg  ) 

returns  list  of  all  but  first  element  of  Ijarg. 

(  c*r  'Ijarg  ) 

equivalent  to  multiple  car  and  edr  (*  =  aa,ad,da,  or  dd).  (This  is  defined  in  'uwstd  J”.) 

( cbar-to>nom  'pjarg  ) 

returns  the  ASCII  code  for  the  first  character  of  s-arg’ s  print  name. 

(  eons  'gjxrgl  'g_arg20  ) 

returns  a  list  /  such  that  (car  /)  »  gjargl  and  (edr  /)  -  g_arg2. 

(  «q  'gjargi  'g_arg2  ) 

returns  t  if  gjargl  and  g_arg2  are  the  same  (identical  !!)  LISP  object. 

(  equal  'gjargl  'g_arg2  ) 

returns  t  if  gjargl  and  gjirgl  are  conformable. 

(  explode  'pjarg  ) 

returns  a  list  of  symbols  whose  single  character  names  are  the  characters  of  pjarg’ s  print  name. 
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(  fset  'sjarg  'lambda  ) 

sets  sjtrg’ s  function  definition. 

(  fsymcval  ’s_arg  ) 

returns  s_arg' s  function  definition. 

(  get  'sjirg  'gjuune  ) 

returns  value  of  s_arg' s  gjtame  property.  (This  is  defined  in  'uwstd.l'.) 

(  Implode  (p_argl  p_arg2  .  . 

inversd  of  explode.  Arguments  with  no  sensible  print  name  are  ignored. 

(  length  ’l_arg  ) 

returns  number  of  elements  in  list  l_arg. 

(  U*t  'gjargl  gjorgl  .  .  .  ) 

makes  a  list  with  elements  g_argl,  etc. 

(  make-symbol  'p_argl  'p_arg2  .  . .  ) 

returns  symbol  whose  pname  is  concatenation  of  pnames  of  its  arguments.  This  is  very  useful  for 
converting  nodes  to  symbols.  See  Implode. 

(  mapcar  'a  June  'Ijarg  ) 

returns  a  list  whose  elements  are  the  result  of  appl3ring  u June  to  each  of  the  elements  in  Ijwg. 
(This  is  defined  in  'uwstd  J'.) 

(  memq  'gjirg  ’l_arg  ) 

returns  tail  of  Ijorg  begining  with  gjarg,  if  g_arg  is  not  in  l_arg,  then  it  returns  nil.  This  uses 
eq  to  test  equality. 

(  null  'gjarg  ) 

returns  t  if  g_arg  is  nil.  not  is  a  synonym  for  nail. 

(  pllst  's_arg  ) 

returns  s_arg'  s  property  list.  (This  is  an  added  built-in  routine.  It  is  not  intended  to  be  used 
directly  by  users.  See  "get”.) 

(  piset  'sjorg  'l_arg  ) 

sets  sjtrg' s  property  list  to  Ijtrg  and  returns  Ijirg. 

(This  is  an  added  built-in  routine.  It  is  not  intended  to  be  used  directly  by  tisers.  See  'putprop'.) 

( pname  'pjirg  ) 

returns  string  equal  to  pjtrg' s  pname. 

(  putprop  'sjorg  'g_val  'gjutme  ) 
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sets  s_arg’  s  gjtame  property  to  g_value  and  return  g_val.  (This  is  defined  in  "uwstdJ”.) 

(  remprop  'sjorg  'gjuane  ) 

returns  s_arg'  s  property  list  from  g_name  on  and  removes  gjuune  property  from  list.  (This  is 
defined  in  'uwstdJ'.) 

(  rplaca  'l_arg  'gjorg  ) 

replaces  car  of  Ijirg  with  gjarg. 

(  rplacd  'Ijarg  'gjtrg  ) 

replaces  cdr  of  Ijvrg  with  gjarg. 

(  set  'sjarg  ’g_arg  ) 

sets  value  of  sjtrg  to  g_arg  and  returns  sjtrg. 

(  sstq  sjirg  'gjarg  ) 

sets  value  of  tjorg  to  gjarg  and  returns  sjorg. 

(  stringp  'gjirg  ) 

returns  t  if  gjarg  is  a  string. 

d J.  I/O  functions 

The  notation  ['fid\  indicates  an  optional  file  identifier  argument.  If  it  is  included  the  operation 
is  directed  to  the  designated  file.  If  omitted  the  operation  goes  to  the  standard  input  or  output  device 
as  appropriate. 

The  strings  used  to  specify  filenames  can  contain  all  the  standard  UNIX  file  name  expansion  con¬ 
ventions  including  the  use  of  environment  variables  (e.g.  *  . .  /  myfile*). 

The  base  used  for  printing  integers  is  controlled  by  the  value  of  the  symbol  'base'.  The  default 
is  decimal,  base  10. 

(  close  'fid  ) 

close  file  specified  by  fid. 

(  Hash  'fid  ) 

force  buffered  output  for  file  fid. 

(  loud  'pjuune  ) 

take  input  from  file  named  by  pjiame. 

If  the  file  is  not  found  in  the  present  working  directory  then  the  directories  specified  in  the 
environment  variable  RNLPATH  will  be  searched.  If  RNLPATH  is  not  defined  then  the  default 
directory  $UW_VLSI_TOOLS/lib/ml  is  searched.  UW_VLSI_TOOLS  is  an  environment  variable 
that  is  used  in  many  of  the  tools  distributed  by  UW/NW  VLSI  Consortium.  This  searching  is 
done  only  for  load. 

( log-file  'pjiame  ) 

closes  the  currently  open  log  file  (if  any)  and  opens  a  log  file  named  pjiame  and  returns  a  fid 
for  the  file,  (log-file  nil)  closes  the  currently  open  log  file.  A  log  file  contains  a  verbatim  copy  of 
everything  that  goes  to  your  terminal  during  the  time  that  it  is  open. 
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(  openi  'p  name  ) 

open  file  with  name  pjuune  for  input,  return /id  for  the  file  opened. 

(  openo  ’pjuune  ) 

open  file  with  name  pjuune  for  output,  return /id  for  the  file  opened. 

(  print  '8_arg  ) 

prints  gju-g  without  trailing  newline. 

(  print  'gjvg  [’/id]  ) 

like  prinl  without  quotes  around  strings. 

(  print  ’gjirg  C/id]  ) 

print  gjirg  followed  by  newline. 

(  printf  [’/id]  'string  'gjirgl  'gjwgl  .  ■ .  ) 

print  gjirgl ...  under  format  control  specified  by  string.  This  is  similar  to  the  printf  in  the  stdio 
library  for  C.  Escapes  for  printing  the  gjsrg'  s  are:  %c->  ASCII  char,  %%->  print  ’%’,  and 
%S>>  print  LISP  object. 

Example:  (setq  a  10) 

(setq  b  ’(list  of  symbols)) 

(printf  ‘’a=%d0=%S0  a  b) 
produces 
a=10 

b=(list  of  symbols) 


(  read  [’/id]  ) 

read  an  S-expression  from  an  appropriate  file.  Returns  the  expression  read  or  the  symbol  end- 
of-fllc  if  the  end  of  the  file  is  reached.  This  does  not  recognize  the  shorthand  syntax  of  the  stan¬ 
dard  read-eval-print  loop. 

(  read-network  'pjiame  ) 

read  a  network  in  file  named  pjuune. 

This  file  must  be  the  output  of  PRESIM.  The  network  described  in  the  file  is  merged  with  the 
networks  already  loaded.  There  is  no  way  to  undo  the  loading  of  a  network  other  than  restart¬ 
ing  RNL. 

(  read-state  'pjuune  ) 

reset  state  of  circuit  to  that  in  file  named  pjuune. 


(  [/id]  ) 

output  newline. 
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(  write-state  'pjuune  ) 

current  state  in  file  named  'p_name.  This  can  be  read  by  read-state  routine. 

6.4.  LISP  Control  Stmctnres  and  Special  Forms 

Although  special  forms  look  like  function  calls,  their  behavior  can  be  quite  different  (especially 
with  respect  to  the  evaluation  of  their  'arguments'). 

Warning:  Lambda  bound  variables  (parameters  to  defun,  lambda,  or  prog)  remain  bound  until  the 
form  is  exited.  Functions  called  from  within  these  forms  will  see  the  new  bindings.  This  is  not  con¬ 
sistent  with  other  dialects  of  LISP. 

(  and  gjxpl  gjexp2  ...  ) 

evaluates  gjexps  left  to  right  until  the  first  nil  result  is  found.  And  returns  the  value  of  the  last 
argument  it  evaluates. 

(  cond  clause  clause  ...  ) 

Following  the  cond  is  a  sequence  of  clauses.  Each  clause  is  of  the  form  (  pred  exp  exp  ...  ).  In 
each  clause  the  first  expression  is  taken  to  be  a  predicate  and  the  remainder  of  the  expression 
the  body  of  the  clause.  Cond  evaluates  the  predicates  in  turn,  stopping  at  the  clause  with  the 
first  non-nil  value  for  the  predicate.  The  body  of  that  clause  is  then  evaluated  and  the  value  of 
the  last  expression  in  the  body  is  returned  as  the  value  of  the  cond.  If  no  predicates  evaluate  to 
non-nil,  nil  is  returned  as  the  value  of  the  cond. 

(  defnn  sjiame  (s j)ar  ...)  exp  ...  ) 

define  function  sjuune  with  formal  parameters  s j)ar  .  .  .  This  is  equivalent  to  (  tset  ’s_name  V 

'( lambda  (s  jar  ...)  exp  ...  )). 

(  do  (l_vrbl  ...)  Ijexitl  expl  exp2  ...  ) 

is  a  generalized  iteration  expression. 

It  has  three  components; 

(i)  a  list  of  iteration  symbol  declarations, 

(ii)  an  exit  clause, 

(iii)  and  a  body  that  is  executed  on  each  iteration. 


The  list  of  iteration  symbol  declarations  are  used  to  declare  temporary  (i.e.  'prog*  bound)  sym¬ 
bols  whose  scope  is  the  do  expression.  Upon  exiting  the  do  they  revert  to  their  previous  status. 
Each  declaration  in  the  list  has  one  of  the  forms; 

(s_sym)  or  (s_sym  ’gjnit)  or  {s  sym  'gjnit  ’gjter) 

wher  s_sym  is  the  symbol  declared,  ’gjnit  is  is  an  expression  whose  value  is  assigned  to  s_sym  at 
the  start  of  the  first  iteration,,  and  ’gjter  is  an  expression  that  is  evaluated  at  the  start  of  each 
successive  iteration  to  provide  successive  values  for  s_sym.  If  'gjter  is  omitted  then  the  value  is 
not  changed  automatically.  The  initialization  and  iteration  expressions  are  evaluated  in  left-to- 
right  order.  For  example,  the  following  declaration  list  says  that  i  starts  at  zero  and  is  incre¬ 
mented  by  two,  and  that  j  starts  at  3  more  than  the  value  of  symbol  k  and  is  squared  on  each 
iteration. 

((i  0  (+  i  2))  (j  (+  k  3)  (•  j  j))) 

The  exit  clause,  Ijxit,  is  a  list  of  the  form 
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(pred  eexpl  eexp2  .  .  .) 

After  the  new  values  have  been  assigned  to  the  iteration  symbols,  the  predicate  pred  is 
evaluated.  If  its  value  is  non-nil,  then  the  eeip’s  are  evaluated  in  order  and  the  value  of  the  last 
is  returned  as  the  value  of  the  do.  If  the  value  of  pred  is  nil,  then  the  body  of  the  loop,  i.e. 
expressions  expl,  exp2,  ...,  is  evaluated.  This  process  is  repeated  until  pred  is  non-nil. 

(  eval  ’g_arg  ) 

evaluates  gjorg  and  returns  the  result. 

(exit) 

exits  rhl  in  an  orderly  fashion,  flushing  buffers,  closing  files  etc. 

(  lambda  (s  jarl  s _par2  ...}  expl  exp2...  ) 

is  the  definition  of  a  (nameless)  function  with  formal  parameters  s _parl  s _par2  . . ..  lambda  itself 
is  not  a  function. 

(  or  gjexpl  g_exp2  ..i  ) 

evaluates  the  g_exps  left  to  right,  stops  when  the  first  all  is  returned.  Or  returns  the  value  of  the 
last  argument  it  evaluates. 

(  prog  (ij  sj  •  •  ■)  'gjf^  'gJfV  ) 

saves  the  old  values  of  s_n  s,  binds  the  symbols  to  all,  and  evaluates  each  of  the  gjexps  in  order. 
The  old  values  are  restored  when  execution  of  the  prog  is  completed.  Returns  the  value  of  the 
last  of  the  gjexps.  Prog  is  used  to  allocate  local  variables  within  a  function. 

(  quote  gjirg  ) 

returns  gjirg  without  evaluating  it.  The  syntax  'gjirg  is  equivalent. 

(  repeat  s  jndex  ’i  jower  'i  upper  exprjist  ) 

is  a  simple  iteration  similar  to  a  for  loop  in  Pascal.  Exprjist  is  the  body  of  the  loop.  Sjndex  is 
the  index  variable,  ijower  and  ijtpper  are  integers  representing  the  initial  and  the  final  values 
of  the  index.  The  index  is  increased  by  one  each  time  the  loop  is  executed.  Returns  the  final 
value  of  the  index. 

6J.  Network  fonettons 

An  electrical  network  consists  of  a  list  of  nodes  transistors,  capacitors,  and  resistors.  The  func¬ 
tions  described  in  this  section  allow  user-defined  functions  to  deal  with  the  network. 

(  !  ’Ijiodes  ) 

prints  a  list  of  the  transistors  whose  gates  are  connected  to  nodes  in  'Ijiodes. 

The  syntax:  !  nodel  node2  ...  is  more  common.  Returns  nil. 

( ?  ’ijiodes  ) 

prints  a  list  of  transistors  whose  source  or  drain  are  connected  to  nodes  in  ijiodes.  The  syntax:  ? 
nodel  node2  ...  is  more  common.  Returns  nil. 

This  command  is  useful  for  wandering  through  the  network  trying  to  track  down  the  source  of  a 
particular  value. 
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(  nnd-node  ’pjorg  ) 

returns  electrical  node  with  print  name  the  same  as  p_arg’  s.  Returns  nil  if  there  is  no  such 
node. 

(  aiatch*nodc  'p  jattern  ) 

uses  p jxutern’ s  print  name  as  a  pattern  using  ’**  as  a  wild  card.  Returns  a  list  of  symbols  whose 
print  names  correspond  to  print  names  of  nodes  that  match  the  pattern. 

(  nodc-valne  'p_arg  ) 

if  a  node  exists  with  a  print  name  matching  pjarg' s  return  its  value  (one  of  0,  1,  or  X),  other¬ 
wise  nil. 

(  node-time  'p_arg  ) 

returns  the  latest  time  in  0.1ns  units  at  whieh  a  change  occurred  in  the  state  of  the  nodename 
provided  in  the  argument.  If  the  node  is  not  found  or  has  not  changed  state,  *nll’  is  returned. 

(  set-delay  'e_node  ’ijplk  'ijpU  ) 

Set  the  transition  times  for  the  specified  node;  tplh  (low-to-high  transition  time)  and  tphl  (high- 
to-low  transition  time)  are  integers  specifying  time  in  lOths  of  nanoseconds.  If  either  tplh  or 
tphl  are  negative,  the  node’s  times  become  unspecified  and  the  transition  times  will  be  deter¬ 
mined  by  the  usual  RC  calculation.  This  command  allows  one  to  override  the  timing  calculation. 
This  is  useful  when  the  RC  calculation  gets  the  wrong  answer  for  one  reason  or  another.  Usu¬ 
ally  this  is  worth  doing  only  on  critical  nodes,  such  as  clocks,  where  an  timing  error  can  be 
significant. 

(  set-node  'cju>de  'gjixp  ) 

set  value  of  node  cjiode  to  gjexp.  adds/removes  node  as  an  input.  If  exp  evaluates  to 

0  node  is  added  to  low  input  list 
1  node  is  added  to  high  input  list 
U,u  node  is  added  to  undefined  input  list 
X,x  ..jce  text... 

The  node  will  be  stuck  at  this  input  value  until  changed  by  another  call  to  set-node.  If  exp  is  X 
(remember  exp  is  evaluated  so  you’ll  probably  want  to  type  ’X),  node  is  removed  from  the  input 
lists.  At  the  next  simulation  step  it  will  acquire  whatever  value  it  would  naturally  have. 

(  aet-ponuns  name  value  ) 

give  a  value  to  one  of  the  simulation  parameters: 

report  flag  (default  =  t).  If  non-nil,  nodes  given  the  value  of  X  because  of 

improper  puUup/puUdown  ratio  or  because  of  charge  decay  will  cause  a 
warning  message  to  be  printed. 

unitdelay  flag  (default  =  nil).  If  non-nil,  all  node  transitions  happen  with  unit  delay. 

decay  fixnum  (default  =  0).  If  non-zero,  tells  the  number  of  time  units  (lOths  of 

nanoseconds)  it  takes  for  charge  on  a  node  to  decay  to  X.  A  value  of  0 
implies  no  decay  at  all. 
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maxres  number  (default  =  lElO).  Capacitors  on  the  far  side  of  transistors  bigger 

than  this  value  don’t  contribute  to  summary  capacitance  used  in  calculat¬ 
ing  transition  times. 

(  set-threshold  'cjtode  'f  vlow  'fj>lugh  ) 

set  cjiode'  s  logic  thresholds  to  f_vlow  (low)  and  f_vhigh  (high),  vlow  and  vhigh  should  be 
numbers  in  the  range  [0,1].  These  thresholds  are  used  when  converting  from  a  Thevenin 
equivalent  voltage  to  a  logic  state  ••  sometimes  it  is  useful  to  be  able  to  override  the  defaults  for 
special  nodes  which  otherwise  will  turn  out  X. 

(  stm-lnlt  ) 

This  finds  all  nodes  whose  values  are  X  and  queues  a  transition  to  0  for  those  nodes.  The 
integer  returned  is  the  number  of  affected  nodes.  A  call  to  sim-step  or  one  of  the  higher  level 
simulation  commands  such  as  'step*,  '$*,  or  *c'  will  allow  these  changes  to  propagate.  Initializa¬ 
tion  should  be  done  by  manipulation  of  the  inputs  of  the  circuit,  simulating  the  real  initialization 
sequence.  Slm-lnlt  can  be  used  to  initialize  nodes  that  cannot  otherwise  be  initialized.  Using 
stm-lnlt  without  first  simulating  the  setting  of  the  inputs  can  be  very,  very  expensive,  especially 
when  trying  to  initialize  circuits  conected  by  a  bus. 

(  sIm-step  'i_stop-time  ) 

simulation  step  using  RC  model.  This  runs  the  electrical  simulation  until  current-time  =  i_stop- 
lime. 

If  the  simulation  runs  to  completion  then  nil  is  returned.  If  a  node  that  has  the  STOPON- 
CHANGE  fiag  set  goes  through  a  transition,  then  the  simulation  is  stopped  at  that  point  and  the 
node  that  had  the  transition  is  returned. 

(  stop-on-change  'cjtode  'gjwitch  ) 

If  g  switch  is  not  nil  then  set  c  node' s  'STOPONCHANGE'  flag.  If  gjwitch  is  nil  then  cjtode' 
s  'STOPONCHANGE'  flag  is  cFeared. 

( swltch-lnlt ) 

like  sim-init,  except  prepares  network  for  initialization  by  switch-step  instead  of  sim-step. 

(  switch-step  'stop-time  ) 

simulation  step  using  switch  model.  This  is  similar  to  sim-step,  but  transistors  are  modelled  as 
switches  and  transitions  have  unit  delay.  This  algorithm  is  somewhat  faster  than  the  usual  RNL 
calculation  for  many  circuits,  but  can  give  X  answers  for  circuits  for  which  transistor  size  is 
important  for  correct  operation  (e.g.,  bit  line  in  a  dynamic  memory).  To  ensure  correct  opera¬ 
tion,  one  should  not  use  sim-step  until  the  event  list  is  empty  (and  vice  versa)  -  i.e.,  all  events 
scheduled  by  a  particular  algorithm  must  be  handled  by  the  same  algorithm.  The  value  of 
event-llst-empty  can  be  tested  to  see  if  the  all  events  have  been  handled. 

This  routine  may  be  useful  when  debugging  the  basic  functionality  of  a  circuit,  or  when  simulat¬ 
ing  a  circuit  which  has  not  been  correctly  sized  (one  that  gives  ratio  errors  using  sim-step).  Since 
the  switch-level  algorithms  are  much  faster  when  dealing  with  large  groups  of  interconnected 
nodes,  switch-step  may  be  particularly  useful  when  initializing  a  network. 

(  walk-net  'function  ) 

function  should  be  a  symbol  or  a  lambda  expression  that  takes  a  circuit  node  as  its  only  argu¬ 
ment.  walk-net  applies  that  function  to  every  node  in  the  network. 
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(  trace-node  'cjtode  ’g_switch  ) 

If  g_$witck  is  not  nil  then  start  to  trace  e_node.  otherwise  stop  tracing  cjtode.  This  is  useful  for 
trying  to  track  down  exactly  what  is  happening  to  a  subciruit  at  a  very  low  level.  The  first  form 
turns  on  tracing  for  the  specified  node,  the  second  turns  it  off.  Sample  outputs: 

[1] :  event  1:  b=H  ®  lOjOns 

[2] ;  b  =>  clist:  d  <  input  seen> 

[31;  d:  rgnd=[3j05e-HH,6.11e+04l.  rvdd=(lj00e+10,1.00e+10l 

[4] ;  d-rgnd=1.18e+04,  d-rvdd®li)0e+10,  lhdelay=0,  hldelay=0 

[5] ;  cap:  high=0i)00000e-t-00.  low=0i)00000e+00,  x=lj014720e-f-00 

[6] ;  =>  value=L  @  120e-t-01  ns 

[7] ;  enquing  d  [event  1:  b]  L  @  220  (delta  -  120) 

[1] :  node  b  makes  a  transition  to  H  at  10.0ns 

[2] :  a  list  (clist)  of  nodes  affected  by  b  is  reported.  In  this  case  one 

node  (d)is  found  before  an  input  ends  the  search.  Inputs  can  be  forced 
nodes,  vdd  or  gnd. 

[3] :  Report  the  result  of  the  Thevenin  calculations  for  nodes  on  the  clist, 

rgnd  Thevenin  resistance  to  ground,  rvdd  Thevenin  resistance  to  vdd. 

Note  in  this  first  case  rgnd  is  computed  to  be  an  interval.  This 
is  the  result  of  an  input  node  having  a  value  of  X. 

[4] :  Report  the  value  of  the  resistors  to  gnd  (d-gnd)  and  vdd  (d-vdd)  used 

in  the  delay  calculations.  Note  these  values  are  not  necessarily 
the  same  as  those  in  [3].  This  is  the  result  of  using  different  values 
for  Rgittie  ,  *Od  Rjynttill  • 

[5] :  Report  the  value  of  total  capacitance  charged  high,  low  and  x  for 

current  node. 

[6,7]:  Compute  new  logic  value  for  node  and  enque  it  at  current-time  + 
delta  (delta  =  RC).  R  and  C  are  choosen  from  the  values  given  in 
lines  [4]  and  [S]. 

[8] ;  event  1  -H  @  10.0ns 

[9] ;  c  =>  clist:  d  <  input  seen> 

[10] ;  d:  rgnd=[lDOe+10,lJOOe+101,  rvdd=[3.05c+043-05e+04] 

[llj;  d-rgnd=lD0e+10,  d-rvdd=5.90e+03,  lhdclay=0,  hidelay=0 

[12] ;  cap:  high=O.OOOOOOe-)-00,  low=lD14720e+00,  x=0.000000e-l-00 

[13] ;  =>  value=H  ®  6.00e+00  ns 

[14] ;  enquing  d  [event  4:  c]  H  @  S31  (delta  >  60) 

This  example  is  substantially  the  same  as  the  first  except  that  the  Thevenin  resistance  is  no 
longer  an  interval. 

( trace-all-Bodcs  'gjwitch  ) 

If  gjwitch  is  not  nil  then  start  to  trace  all  nodes,  otherwise  stop  the  trace.  Sometimes  this  is 
the  only  way  to  track  down  oscillating  subcircuits. 

7.  The  awslni.l  package. 

The  uwtimJ  package  is  intended  to  provide  a  powerful  and  easy  to  use  front  end  for  rni.  In 
addition,  it  is  can  serve  as  the  basis  for  customized  front  ends  for  specific  projects.  In  this  document 
we  concentrate  on  the  functions  intendend  to  be  directly  called  by  users.  The  programmer  who 
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intends  to  extend  this  or  to  eustomixe  it  is  invited  to  peruse  the  code. 

7.1.  Syntax  and  symbols. 

The  uwsimJ  package  defines  two  new  data^structures:  Vectors  of  circuit  nodes  are  defined  by 
vecdef’  s.  A  vecd^  is  a  list  of  the  form  (  sjnode  tjuune  cjiodel  ...  cjioden).  sjnode  is  one  of  {hex, 
dec,  oct,  bin,  bit}  and  controls  the  formatting  of  output  and  input  for  the  vector.  The  first  four  modes 
allow  numeric  input  in  any  base  and  output  in  the  specified  base  (and  are  limited  to  23  nodes),  the  bit 
mode  uses  bit  vector  input  and  output.  If  a  numeric  vector  contains  undefined  nodes  it  is  printed  as  a 
bit  vector.  The  first  element  in  the  list  of  nodes  is  the  high-order  bit  of  the  numeric  vector. 

You  can  request  that  a  report  about  the  state  of  your  circuit  be  printed  at  certain  times  during  the 
simulation  (usually  at  the  end  of  a  clock  cycle).  The  format  of  this  report  is  specified  by  a  report- 
form  which  is  a  list  containing  vecdef  s  ,  strings,  symbols  corresponding  to  nodes,  nodes,  and  the  for¬ 
mat  control  symbols  {  acwllnc,  tab,  and  page}  printing  of  a  report.  The  car  of  the  list  is  a  string  that 
heads  the  report. 

The  following  symbols  are  global  variables  defined  in  uwsimi  and  should  not  be  used  for  nodenames. 
These  variables  however  can  be  used  in  programs  for  the  appropriate  purpose. 


t  The  property  list  of  ”t*  is  used  to  hold  tokens  describing  which  packages  have 

been  loaded.  UwsimJ  requires  that  uwstdJ  he  loaded  first. 

incr  This  variable  is  the  simulation  step  time  interval  in  0.1ns  units,  used  by  the  step 

and  clock  functions;  the  default  value  is  1000  for  100.0ns. 

relative-timing  If  this  variable  is  not  'nil'  then  transition  times  are  reported  relative  to  the  start 
of  the  simulation  step.  Default  is  ’not  nil’  =  ’t’. 

switch-level  If  "switch-IeveT  is  non-nil  then  the  switch-level  model  is  used,  otherwise  the  RC 
model.  Default:  switch-level  =  ’nil’.  Note:  the  simulator  switch  level  model  docs 
not  appear  to  work  satisfactorywith  cmos  and  dynamic  circuitry.  Its  use  is 
discouraged  with  this  version  of  ml. 

lanalyze  The  global  variable  lanalyze,  if  ’not  nil’  =  ’t’  prevents  printing  of  all  description 

texts  and  limits  the  report  output  defined  in  def-report  to  node  and  vector 
states.  The  first  column  of  the  report  is  the  current  time  in  ns.  Default  is  "niT. 

glitch-detect  If  this  variable  is  ’not  nil’  =  ’t’  then  only  multiple  changes  of  the  nodes  defined 
in  the  chfiag  command  are  reported.  Single  transitions  are  NOT  reported.  A 
chflag  command  defined  which  nodes  are  subject  to  glitch-detection  must  be 
included  before  starting  the  simulation  .The  default  value  of  glitch-detect  is  ’nil’. 

triggering  If  this  variable  is  ’not  nil’  =  ’t’  the  logic  triggering  function  is  enabled.  The 
default  is  ’nil’. 

trigger_flag  This  variable  is  used  to  prevent  additional  triggercommand  execution  when  a 
triggercondition  persists.  This  variable  is  not  for  external  use. 

triggerjndex  Contains  >he  number  of  occurenees  of  the  trigger  condition.  Is  initialized  at  1. 

Can  be  used  to  influence  trigger  handling  as  a  function  of  the  number  of  trigger 
conditions  detected. 
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trigger_file  Contains  the  filename  where  ml  will  look  for  the  commands  to  be  executed  in 
case  a  trigger  condition  occurs.  Default  is  'trig_file*. 

7  FuBctloos  Intended  for  Direct  Use  by  Users. 

(  defvec  'veedrf  ) 

optimizes  the  representation  of  veedef  by  converting  LISP  symbols  into  nodes  and  stores  that 
representation  as  the  veedef  property  of  veedrf"  s  name. 


(  defveev  ) 

Defined  a  single  indexed  vector  of  type  *type'  (bit/bin/oct/hex/dec)  name  ’basename’  and  elements 
number .(start_index-t-number_elements)  down  to  number.(start_index) 

( defvecl } 

Defines  ’indexl’  vectors  with  names  ’basename_l’  'basenamejndez*  with  double  indexed  node 


(  def-report  ’Ijarg  ) 

creates  an  optimized  report  form.  l_arg  is  a  list,  beginning  with  a  title  string,  containing  the  fol¬ 
lowing  LISP  forms:  strings  are  printed  in  the  report  without  surrounding  quotes. 


newline 


(vec  s_arg) 


(vec  veedef) 


(function  g_arg) 


inserts  a  newline  in  the  output, 
inserts  a  tab  in  the  output, 
inserts  a  form  feed  in  the  output. 

for  symbols  other  than  those  above  causes  the  state  of  the 
corresponding  node  (if  any)  to  be  displayed.  An  error  is  reported 
and  a  newline  is  inserted  if  sjirg  cannot  be  converted  to  a  node. 


causes  the  state  of  a  vector  to  be  inserted  in  the  report.  If  the  first 
form  is  used,  s_arg  should  have  been  previously  been  given  a  vector 
definition.  If  the  second  form  is  used,  the  vector  definition  is  created 
on  the  fly. 

causes  gjarg  to  be  evaluated  when  this  form  is  encountered  in  the 
printing  of  the  report 


( def_rcporti  l_arg  ) 

same  as  def_report  except  multiple  vectors  can  be  defined  as  in  defvccl  ;  such  vectors  are  aefined 
with  (  veci  basename) 
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(  h  'Ijtodet  ) 

makes  the  nodes  in  Ijwdes  inputs  at  logical  high  (1).  (Alternate  syntax:  h  nodel  nodc2  ...) 

(  I  ’tjiodes  ) 

makes  the  nodes  in  Ijtodea  inputs  at  logical  low  (0).  (Alternate  syntax:  1  nodel  node2  ...) 

(  X  'Ijtodes  ) 

removes  the  nodes  in  Ijicdes  from  the  input  list.  They  can  now  be  driven  high  or  low  by  the 
modelled  circuit.  (Alternate  syntax:  x  nodel  node2  ...) 

(  n  'Ijiodes  ■) 

makes  the  nodes  in  Ijiodex  to  be  undefined  inputs.  (Alternate  syntax:  u  nodel  node2  ...) 

(  t  'Ijtodes  ) 

turns  on  traces  for  nodes  in  Ijtodes.  (Alternate  syntax:  t  nodel  node2  ...) 

(  at  'Ijtodes  ) 

turns  off  traces  for  nodes  in  Ijtodes.  (Alternate  syntax:  ut  nodel  node2  ...) 

(  Invcc  ’(  vecjtame  gjcdl  g_val2  ...)  ) 

checks  the  type  of  vecjtame.  If  the  vector  is  one  of  the  numeric  types  (hex,  dec,  oct,  or  bin) 
then  it  assigns  the  numeric  value  gjvall  to  the  vector.  Otherwise,  it  treats  the  vector  as  a  bit 
vector  and  assigns  the  value  gjfall  to  the  first  node  in  the  vector,  gjfal2  to  the  second,  etc. 

(  bitinvcc  ’(  vec-name  gjall  gjval2  ...}  ) 

is  like  Invcc  but  forces  the  input  to  be  in  the  bit  vector  form.  This  function  allows  elements  of 
the  vector  to  be  set  to  x  or  a. 

(  opcnplot  '(fUejiame)  ) 

opens  a  plot  file  to  receive  notifications  of  reported  transitions.  The  resulting  plot  file  can  be 
processed  by  the  program  mtp  to  produce  plots  that  resemble  logic  analyzer  displays.  Note  the 
output  is  controlled  by  specifications  of  chflag.  cltflagv  and  cftflagi  ! 

(  cloaeplot  'Ijsrg  ) 

closes  the  plot  file.  The  argument  is  ignored. 

(  markplot  marker  ) 

inserts  a  marker  with  the  name  marker  in  the  plot  file. 

(  ■  'Ij^rg  ) 

runs  a  simulation  step  for  Iner  simulated  time  and  generates  a  report  at  the  end.  (Sec  def>rcport. 

) 

(  e  ’( ) 

runs  a  two-phase  non-overlapping  clock  for  ijsrg  cycles.  This  assumes  that  the  clock  nodes  are 
called  phtl  and  phU.  Each  of  the  4  periods  is  incr  long.  At  the  end  of  ijsrg  cycles  a  report  is 
attempted  using  the  user’s  declared  format. 
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(  vccnamef  arg  ) 

arg  should  be  either  vector  definition  or  a  symbol  with  a  vector  definiton.  It  prints  out  the 
names  and  current  values  of  the  vector. 

(  vccBodcs  arg  ) 

arg  should  be  either  vector  definition  or  a  symbol  with  a  vector  definiton.  It  returns  the  list  of 
component  nodes  of  the  vector. 

(  onchanged-slnce  'njime  ) 

returns  a  list  of  nodes  that  have  not  changed  since  njime.  This  is  useful  for  helping  to  decide 
whether  your  simulation  has  adequate  coverage. 

( nnehanged  'Ijtrg  ) 

is  shorthand  for  (unchanged-since  0).  The  argument  is  ignored. 

(  chflag  'l_arg  ) 

sets  the  'STOPONCHANGE*  flag  for  the  nodes  in  Ijwg. 

(  anchflag  'Ijorg  ) 

clears  the  "STOPONCHANGE”  flag  for  the  nodes  in  l_arg. 

(  chflagv  ) 

This  command  will  add  all  nodes  in  the  vector,  assumed  to  have  normal  extensions  of  a 
base_name  (like  in.l  in.2  in3  .....  etc)  to  the  list  of  nodes  with  the  *STOPONCHANGE*  flag  set. 
Startjndex  is  the  value  of  the  first  node  (normally  *0*  or  *1*)  and  vector_^e  is  the  number  of 
elements  in  the  vector. 

(  onchflagv  ) 

This  command  will  remove  all  nodes  in  the  vector  from  the  list  of  nodes  with  their  *STOPON- 
CHANGE*  flagset.  Assumed  is  that  the  nodenames  all  have  extensions  of  type:  basename.l 
basename.2  etc.  Complement  of  the  *chlagv*  command. 

(  chflagi ) 

Sets  the  'STOPONCHANGE*  flag  for  all  nodes  withnames  basename  j.j  where  i  from  1  to  indexl 
and  j  from  1  to  index2. 

(  anchflagl  ) 

Disables  the  'STOPONCHANGE'  flag  for  all  nodes  with  names  basenamei.j  where  i  from  1  to 
indexl  and  j  from  1  to  index  2. 

(  wr'fomiat ) 

This  command  writes  the  nodes  and  vectors  in  order  as  they  appear  in  a  logic  analyxer  style  out¬ 
put. 

( Inlt  ’state  ) 

State  can  be  either  7*  or  ’h’.  This  routine  does  more  reporting  than  simjnit;  also  signals  can  be 
preset  high  (useful  since  many  dynamic  CMOS  circuits  are  pre-charged  high  and  start-up  time  of 
normal  simulation  can  be  substantially  reduced. 
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hut  does  the  following: 

The  routine  finds  all  nodes  with  undefined  states  ‘x’  in  the  network  and  reports  the  number 
of  undefined  nodes  found.  Then,  as  determined  by  the  argument  either  low  or  high  is 
applied  to  these  nodes  and  a  simulation  step  is  run. 

liiereafer  all  previously  clamped  nodes  are  released  again  and  up  to  10  simulation  steps  are 
run  until  the  network  has  settled  and  the  number  of  simulation  steps  necessary  to  settle  the 
network  is  reported.  A  warning  message  is  provided  if  the  network  has  not  settled  within 
10  simulation  steps. 

Finally,  the  routine  again  traverses  the  network  and  reports  the  number  of  nodes  still  in 
the  undefined  states. 


7  J.  Fanctions  Intended  to  be  Called  by  Other  Fnnetions. 

There  are  a  lot  of  these  functions.  You  are  invited  to  look  at  uwsimJ. 

In  addition,  they  provide  examples  of  how  many  of  the  elements  of  this  language  are  util¬ 
ized. 
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This  document  is  intended  as  a  guide  for  people  who  want  to  acquire  a  basic  working  knowledge 
of  the  RNL  digital  circuit  simulator  and  the  NETLIST  network  deseription  program  in  the  UW/VLSI 
VAX  11/780  environment.  Examples  are  given  for  the  preparation  of  logic  network  description  files 
and  the  production  of  the  oorreqKmding  aim  and  binary  files  for  input  to  RNL.  Next,  instruction  on 
the  use  of  RNL  commands  to  set  op  a  clearly  defined  network  state  for  a  simulation  is  provided.  Per¬ 
forming  actual  simulations  of  tome  of  the  networks  defined  previously,  frequently  needed  commands, 
such  as  those  for  setting  circuit  values,  asking  about  node  information,  running  a  simulation  step,  etc., 
are  e:q>lained  and  applied  to  the  network  in  both  interactive  and  batch  mode.  Further  references  are 
listed  in  the  appendix. 

If  you  ate  not  familiar  with  the  UNIX  operating  system,  read  the  introductory  document  UNIX- 
quick. 
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1.  Format  CoBventloni  for  thb  Docamcnt: 

The  UNIX  system  prompt  is  given  as  a  small  percent  sign  (  «  )  in  bold-face  type. 

(The  RNL  command  interpreter  has  no  prompting  sign,  which  can  sometimes  be  confusing.) 

All  information  RNL  prints  out  in  response  to  your  entries,  including  error  messages,  are  indicated 
in  nsU  baid-raM  tjry*.  If  a  short  description  of  what  RNL  returns  to  you  is  given  instead  of  the  actual 
RNL  response,  it  is  also  shown  in  small  bold-face  type. 

Your  entries  are  indicated  in  bold-face  type,  normal  size. 

Certain  commands  and  phrases  within  the  text  are  also  printed  in  bold-faced  letters  for  emphasis. 

Program  names  within  the  text  are  frequently  capitalized  for  emphasis  (e.g.  PRESIM  for  presim). 

File  names  are  indicated  in  italic  type  (unless  they  are  part  of  an  entry  sequence,  in  which  case  they 
are  shown  in  bold-face  as  is  everything  else  that  is  part  of  an  entry). 

<  CR>  stands  for  the  RETURN  key. 

*  (Caret)  stands  for  the  CONTROL  key  (frequently  labeled  CTRL).  If  precedes  a  character,  the 
CONTROL  key  has  to  be  pressed  and  held  down  while  the  character  key  is  pressed. 

DELETE  and  <  DEL>  stand  for  the  DELETE  key. 
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2.  Overview  of  the  Position  of  NETLIST  end  RNL  In  the  UW/VLSl  Tool  Environment 

The  Jim  file  plays  a  central  role  in  connecting  NETLIST  and  RNL  with  the  rest  of  the  UW/VLSI 
tools,  as  well  as  with  each  other  (see  Figure  1).  The  name  Jim  file  derives  from  the  mandatory  file 
name  extension  jim. 

In  this  tutorial,  we  will  use  NETLIST  to  produce  a  xim  file  from  a  logic  network  description  file,  then 
transform  the  jim  file  with  the  program  PRESIM  into  a  binary  network  description  file  for  input  to 
RNL.  We  will  not  deal  with  the  generation  of  the  jim  file  with  other  tools,  such  as  MEXTRA,  nor 
will  we  consider  the  possibility  of  using  the  jim  file  for  input  to  programs  other  than  RNL. 

RNL  must  be  given  two  sets  of  information  for  a  simulation  run.  These  are: 

(a)  a  description  of  the  network  to  be  simulated  and 

(b)  the  commands  to  control  the  simulation  run. 

The  network  description  specifies  the  elements  of  the  network  (such  as  transistors,  NANDs,  etc.)  and 
the  way  they  are  interconnected.  The  RNL  command  input  performs  functions  such  as  setting  the  ini¬ 
tial  state  of  the  network,  providing  signals  to  be  applied  to  the  network  (input  signals,  clock,  _.), 
specifying  the  format  of  the  simulation  report,  etc. 

We  will  deal  with  the  network  description  first,  and  later  use  the  networks  defined  in  this  way  to 
illustrate  the  generation  of  the  RNL  command  input. 

The  RNL  command  input  can  be  entered  in  two  ways:  interactively,  or  via  a  command  file  submitted 
to  RNL  (batch  mode).  You  may  use  a  command  file  to  initialize  the  network  or  to  apply  complex 
stimulus  signals,  and  then  continue  to  work  with  RNL  interactively.  In  interactive  mode,  you  can  do 
simple  simulations  and  develop  programs  in  RNL  LISP,  which  may  be  run  in  batch  mode  subse¬ 
quently.  In  most  RNL  sessions  you  will  probably  find  yourself  alternating  between  interactive  and 
batch  mode. 

There  are  conventions  for  the  names  of  the  files  to  be  processed  by  NETLIST,  PRESIM  and  RNL. 
These  conventions  will  be  observed  in  this  tutorial.  All  files  related  to  a  particular  circuit  are  given 
the  same  main  name  followed  by  a  period  (.)  and  an  extension.  The  binary  input  file  for  RNL  is  an 
exception  to  this  rule  -  it  has  no  extension. 

The  meanings  of  the  extensions  are: 

Jiet  network  description  file,  input  to  NETLIST 

aim  intermediate  file,  output  of  NETLIST  and  input  to  PRESIM; 

this  file  is  a  true  'mediator'  -  it  forms  the  connection  not  only  between 
NETLIST  and  RNL,  but  also  between  NETLIST  and  the  other  VLSI 
tools,  and  RNL  and  the  other  VLSI  tools. 

J  conunand  file  for  RNL  (batch  mode) 

.al  alias  file  produced  by  NETLIST* 

*  Normally  you  do  oot  have  much  to  do  wiib  the  ^  file,  it  it  created  automatically  by  NETLIST  and  uaed 
automatically  by  PRESIM. 
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Figure  1 

Position  of  NETLIST  and  RNL  in  the  UW/NW  VLSI  Tool  Environment. 
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no  extension:  binary  network  description  file,  output  of  PRESEM,  input  to  RNL 

You  need  not  follow  these  file  name  conventions,  but  it  is  strongly  recommended  since  it  makes  the 
communication  between  various  users  much  easier. 


3.  Logic  Network  Descriptions  for  NETLIST 


3.1.  A  CMOS  Inverter  as  a  Simple  Example 


3.1.1.  The  NETLIST  Logic  Cireolt  Description  of  an  Inverter 

Recall  from  section  1.  that  RNL  needs  to  know  the  network  before  you  can  start  your  simulation*. 
We  will  describe  here  how  the  network  can  be  specified  for  NETLIST  in  a  logic  network  description 
file  using  a  LISP-like  command  syntax. 

You  therefore  should  familiarize  yourself  with  the  basics  of  LISP,  if  necessary.  To  help  you  with  this, 
this  section  will  provide  an  example  of  a  logic  network  description  and  an  implicit  description  of  some 
important  LISP  properties,  but  will  omit  much  of  the  detail  and  the  intricacies  of  LISP. 

Figure  2.  shows  the  circuit  diagram  of  our  first  example,  a  simple  CMOS  inverter.  We  will  prepare 
the  logic  network  description  for  the  inverter  according  to  this  diagram. 

Vdd 


I — 'if 


GND 


Figure  2  CMOS  Inverter 


*  Howcvcf ,  it  it  powiblc  to  add  to  yout  network  in  the  conne  of  the  aanilation. 
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The  general  form  of  a  NETLIST  (and  RNL)  eommand  is: 

(commaBd.aaac  argonMnt_l  argnaMBl.l  •rgBmeBt_3  ...) 

In  most  eases  the  parentheses  are  required.  You  will  Snd  later  in  this  tutorial  examples  for  eases 
where  the  parentheses  can  be  left  out.  (In  particular,  RNL  has  a  syntax  simplification  designed  to 
save  you  some  typing  of  parentheses). 


Here  is  a  listing  of  the  logic  network  description,  followed  by  the  explanation  of  its  commands  (write 
the  network  description  into  a  file  named  inverter  Jiet.)  : 

;  (1)  NETWORK  DESCRIPTION  FOR  A  CMOS  INVERTER 

•  -  -  - 

;  (2)  DECLARATION  OF  THE  NODES  IN  THE  NETWORK 
(node  1b  oot) 

;  (3)  P-CHANNEL  ENHANCEMENT  TRANSISTOR  (PULL>UP) 

(ptraas  tai  oat  Vdd  t  S) 

;  (4)  N-CHANNEL  ENHANCEMENT  TRANSISTOR  (PULL-DOWN) 

(etroBS  Ib  GND  eat  4  S) 

;  (S)  SPECIFYING  AN  INTERCONNECT  CAPACITANCE  FOR  THE  OUTPUT  NODE 
(capaclUBcc  oot  0.03) 


Hereafter,  the  numerals  enclosed  in  parentheses  will  be  used  to  indicate  each  part  of  the  description 
file. 

(1)  Note  that  a  semicolon  causes  the  rest  of  the  line  to  be  treated  as  a  comment,  ix.,  to  be  ignored 
by  the  NETLIST  program.  Blank  lines  are  also  ignored*. 

This  first  comment  serves  as  a  title  to  the  network  description  file. 


(2)  You  must  declare  any  node  you  want  to  name  for  subsequent  reference,  (you  could  think  of 
this  declaration  as  bringing  the  nodes  named  by  you  to  the  attention  of  RNL)**.  There  are  a 
few  exceptions  to  this  rule,  however.  Some  nodes,  common  to  most  circuits,  are  known  to  RNL 
without  declaration.  These  are  the  ground  and  drain  voltage  potential  connections***  symbol¬ 
ized  GND  and  Vdd  (the  symbols  GND  and  Vdd  are  not  sensitive  to  upper  or  lower  case,  so 

*  You  ifaould  sake  ample  oae  of  such  conmenti  aod  Mank  iiuet  to  make  your  oetwork  Ble  at  'readaMe*  aa 
powibte. 

**  There  are  aluwet  alwayi  additional  nodea  named  hy  NETLIST  (or  other  programa  producins  a  ebm  Ale). 

Tbia  bappena,  for  eiamNe.  trben  NETLIST  proceaaea  a  aaacro  which  baa  internal  fiocal)  nodes.  Such 
namea  go  undeclared.  You  will  6nd  many  of  them  in  moat  aim  Uea. 

***  We  use  the  term  'drain  voltage  potential*  despite  the  fact  that  in  many  cases  the  drain  of  a  translator 
may  be  connected,  not  to  Vdd,  but  to  any  other  node.  Notably  iNa  it  the  case  with  tranamitaioo  gates. 
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gnd  and  vdd  are  equivalent  symbols). 

Nodes  are  declared  with  the  ctmimand 

(node  b1  b2  b3  b4  ), 

where  nl,  b2.  n3,  n4,  ..  ate  the  names  of  the  nodes  to  be  referred  to  in  the  network. 


(3)  The  declaration  of  the  nodes  has  provided  the  'skeleton'  for  the  network.  Next  you  must  'fill 
in'  the  remainder  of  the  circuit.  For  a  transistor  this  is  done  with  a  command  of  the  form 

(traBslater*typc  gate  soarca  drain  wMtk  length). 

Tranststor-type  represents  a  mnemonic  for  various  types  of  transistors,  such  as 
ptrans  for  p-channel  enhancement-mode  transistor 

etrana  for  n-channel  enhancement-mode  trannstor 

dtrans  for  n-channel  depletion-mode  transistor 

(see  NETLIST  User’s  Guide  for  more  available  transistor  types  and  other  circuit  ele¬ 
ments.) 


Gate,  soaree,  and  drain  represent  the  names  of  the  nodes  to  which  the  gate,  the  source,  and  the 
drain  of  the  transistor  are  connected. 

The  pull-up  of  the  inverter  is  specified  as  a  p-channel  enhancement-mode  transistor,  and  the 
appropriate  nodes  are  'in',  'out',  and  'Vdd'. 

The  width  and  the  length  of  the  transistor’s  gate  area  in  units  of  lambda  may  be  q>ecified 
optionally.  If  omitted,  both  width  and  length  default  to  2  lambda.  Our  puU-up  b  given  a 
width  of  8  lambda  and  a  length  of  8  lambda. 

The  width  and  the  length  of  the  gate  area  determine  the  resistance  of  the  transutor*.  In  this 
way  you  can  influence  the  ratio  of  the  puU-up  to  pull-down. 


(4)  The  pull-down  b  specified,  analogously  to  (3),  as  an  n-channel  enhancement-mode  transutor 
with  a  gate  width  of  4  and  a  gate  length  of  8. 

(5)  The  final  element  to  be  q>ecified  in  the  inverter  b  the  interconnect  capacitance.  The  command 

(capnettanee  out  0.03) 

telb  NETLIST  that  a  capacitance  of  0.03  pF  b  to  be  inserted  between  the  nodes  'out'  and 
GND.  (One  side  of  a  capacitance  specified  with  thb  command  b  always  to  GND).  The 
specification  of  thb  capacitance  is  an  estimate  of  the  load  capacitance  of  the  inverter. 

*  RNL  dctefminci  the  retittaoce  by  lookiaf  np  ■  two-diaMB4oaai  uMe  io  which  the  diineaiioac  arc  taaflh 
and  width.  la  thia  way  the  iaflueoce  of  the  geoaictry  of  the  gate  area  oo  the  effective  (empitical)  reeistaoce 
ouy  be  taken  into  aceovnt. 
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3.U.  Procealn^  the  Dcscriptton  File  with  NETLIST  ud  PRESIM 

After  the  logic  network  description  has  been  written  to  the  file  imerterjut,  it  has  to  be  processed 
with  the  NETLIST  and  PRESIM  programs. 

Substitute  'inverter*  for  'example*  in  the  file  names  from  Figure  1.  (Yo  i  already  prepared  the  file 
inverierjiet.) 

Then  enter: 

wnetUst  Inverter Jtct  Inverter .Rni  <CR> 

This  causes  NETLIST  to  process  the  network  description  file  inverter  jut,  writing  its  output  to  the  file 
inverter  Jim.  If  you  omit  the  filename  inverter  jim,  NETLIST  will  diq>Iay  the  output  on  the  screen**. 
(Enter  *  man  netUst  or  see  NETLIST  User’s  Guide  to  get  more  information  about  optional  parame¬ 
ters  for  NETLIST). 

If  everything  worked  out  correctly,  the  only  response  you  will  get  is  the  UNIX  prompting  sign  (%). 

You  may  want  to  look  at  the  inverter  jim  file  produced  by  NETLIST.  Its  content  is  listed  and 
analyzed  for  this  example  in  the  appendix. 

The  next  step  is  to  process  inverter  jim  with  PRESIM.  PRESIM  transforms  the  transistors  in  the  jim 
file  into  resistors  of  equivalent  size.  This  is  done  because  RNL  uses  resistor  models  for  the  transistors 
and  estimates  transition  time  delays  from  the  equivalent  network  formed  by  the  resistors  and  the  cir¬ 
cuit  capacitances. 

There  is  an  optional  configuration  file  which  can  be  used  to  give  to  PRESIM  technology-dependent 
parameters,  such  as  the  specific  resistances  of  the  transistor  channels.  If  you  do  not  use  this 
configuration  file  in  the  PRESIM  rue,  default  values  for  the  specific  channel  resistances  are  assumed. 
The  assigned  default  values  are  the  same  for  all  the  different  transistor  types,  which  results  in  a  resis¬ 
tance  ratio  of  1  if  the  gate  areas  for  the  pull-down  and  the  pull-up  transistors  are  sized  equally. 

An  explanation  is  given  in  the  appendix  on  how  to  prepare  a  simple  configuration  file  to  change  the 
channel  resistance  of  the  p-channel  transistor  to  twice  the  value  of  that  of  the  n-channel  transistor. 
Read  this  appendix  or  simply  prepare  the  very  short  coitfig  file  (six  lines)  from  the  listing  there.  You 
can  then  run  PRESIM  with  the  coitfig  file  as  a  parameter: 

«  presim  Inverter  jlm  Inverter  cenflg  <  CR> 

This  will  cause  PRESIM  to  process  inverter  jim,  putting  the  output  into  the  file  inverter.  This  output  is 
a  binary  file. 

PRESIM  will  give  you  some  information  about  what  it  did: 
vinmej 

Saedn;  whOmmsi  ak^l  l«ilHk«e  s-cha*l  eipHI  lew-ewnr'-'f  wmUtm^ 

Ttlal  tnuUstan  tllMlaWae  •  2 


**  to  fact,  it  will  go  to  the  UNIX  ttaadard  output,  wUeb  ii  ooroMlIy  iniiDed  to  the  tcreen.  Of  coutae,  you 
nay  redirect  the  ctandard  output  (e.g.  to  a  file). 
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First,  it  tells  you  its  version  number,  which  is  42.  Then,  you  are  informed  that  eight  nodes  were 
found  in  the  network.  If  you  look  at  Figure  2,  you  mi^t  count  only  four  nodes,  but  PRESIM  counts 
some  of  the  nodes  more  than  once. 

PRESIM  tells  you  how  many  transistors  of  the  ^rious  types  it  found  in  the  circuit  and  how  many 
transistors  it  'eliminated*. 


You  could  now  use  the  inverter  file  as  the  binary  network  description  for  RNL  and  run  a  simple  simu¬ 
lation.  However,  the  example  of  the  inverter  was  only  intended  to  be  a  simple  exercise  to  give  you  a 
feeling  for  the  way  networks  are  described  using  NETLIST.  We  will  connder  the  network  description 
of  a  more  complex  network  before  proceeding  to  an  actual  simulation. 


3 NETLIST  DcacrIptloB  File  for  a  Tea-Bit  Shift  Register  Made  from  Latches  and  Flip-Flops 


3J.1.  Deflalag  Macros  as  BoUdlag  Blocks  (Latches  and  Flip-Flops)  -  BoUdlag  Block  Library 

We  are  going  to  build  the  shift  register  in  a  modular  fashion  as  illustrated  in  Figure  3a  through  3c. 
First  we  make  a  latch  from  inverters  (3a),  then  we  put  together  two  latches  to  get  a  master-slave  fiip 
flop  (3b),  and  finally  we  chain  tea  flip-flops  to  build  the  drift  register  (3c). 


in 

cl 

cl- 


-out 


Figure  3a  Latch 
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Figure  3b  MS  Flip  Flop  (made  from  Latches) 


Figure  3e  Shift  Register  (made  from  auhtt) 


Since  it  can  already  be  seen  that  we  may  need  latches  and  flip-flops  in  future  designs,  we  will  define 
these  building  blocks  such  that  we  can  later  call  them  without  having  to  redefine  them.  This  is  done 
with  macro  definitions,  which  can  be  stored  in  a  library  file  and  easily  loaded  into  future  network 
description  files.  The  library  file,  which  we  shall  call  network  library,  has  the  same  format  as  the  Jier 
files.  We  give  it  the  name  libjut.* 

Here  is  the  listing  of  the  macro  definition  of  the  latch,  followed  by  the  explanation  of  its  statements 
(see  also  Figure  3ji): 


;  (1)  MACRO  DEFINITION  FOR  A  CMOS  LATCH 

•  -  -  -  -  - ■■■■■■■■ — — - 

;  (2)  NAMING  THE  MACRO  AND  ITS  PARAMETERS 
(macro  latch  (oat  la  cl  cl>) 

*  It  if  not  oeoewary  to  store  tbe  macro  defiaitioas  io  a  library  Die.  You  may  choose  to  write  the  macro 
detoitioM  directly  at  tbe  begiDaing  of  the  network  descriptioo  file. 
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:  (3)  DECLARATION  OF  THE  NODES  LOCAL  TO  THE  LATCH 
(local  at) 

;  (4)  FIRST  CLOCKED  CMOS  INVERTrai 
(cIUdt  bI  ia  cl  cl-) 

;  (5)  UNCLOCKED  CMOS  INVERTER 
(clavcrt  oat  at) 

;  (O  SECOND  CLOCKED  CMOS  INVERTER 
(clkiav  b1  oat  cl-  cl) 

:  (7)  CLOSING  PARENTHESIS  FOR  THE  MACRO 

) 


(1)  This  is  the  title  identifying  the  library  entry. 

(2)  A  macro  definition  has  the  general  format 

(macro  name  (paraad  paraml  paramS  ...) 
body  of  the  macro 
) 

Note  the  closing  parenthesis  after  'body  of  the  macro*,  and  make  sure  that  you  never  forget 
them  in  any  macro  definition.  You  should  invent  short  and  descriptive  names,  but  do  not  use 
the  name  of  any  of  the  other  NETLIST  functions  (as  listed  in  the  NETLIST  User’s  guide.). 
The  body  of  the  macro  is  made  up  of  the  statements  (2)  through  (6). 

We  give  our  macro  the  name  'latch*.  The  name  is  followed  by  a  list  of  parameters  paraml, 
param2,  param3, ...  These  parameters  represent  the  values  to  be  used  when  the  macro  is  called 
later.  In  the  latch  macro,  they  represent  the  names  of  the  nodes  that  are  used  to  connect  the 
latch  to  other  circuits. 

(3)  There  is  one  node  to  which  one  need  not  refer  when  the  latch  is  used  later.  This  node,  'nl”,  is 
only  of  local  importance  to  the  latch.  Therefore  it  is  declared  as  a  local  node  in  the  latch 
macro.  Locally  declared  node  names  may  be  declared  and  re-used  in  other  macros,  since  they 
are  considered  free  symbols  outside  the  macro  of  their  declaration. 

(4)  As  ia  the  previous  example  of  the  inverter,  the  nodes  form  only  a  'skeleton*  for  the  network 
which  must  be  'filled  in*  with  the  circuit  elements.  The  circuit  elements  are  two  clocked 
inverters  and  an  unclocked  inverter.  These  elements  are  available  in  standard  form  as  com¬ 
mands  for  the  network  description.  (This  means  we  need  not  have  taken  the  trouble  to  describe 
the  inverter  with  single  transiston  ia  section  3.1.  However,  we  did  this  as  an  example  of  a  sim¬ 
ple  circuit,  and  to  demonstrate  the  use  of  transistors  in  a  network  description.) 

A  clocked  CMOS  inverter  is  specified  with  a  command  of  the  form 
(dkbav  eat  la  elk  elk-). 
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'clkinv*  is  a  mnemonic  for  'CMOS  clocked  inverter*,  'out',  'in',  'elk',  and  'elk-'  represent 
the  names  of  the  nodes  to  which  the  output,  input,  clock  input,  and  negated  clock  input  are 
connected  (the  clock  input  is  the  base  of  the  n-channel  transistor,  the  negated  clock  input  is 
the  base  of  the  p-channel  transistor).  In  (4),  a  clocked  inverter  is  connected  to  the  respective 
nodes  out,  in,  cl,  and  cl-.  (The  gate  sizes  and  ratio  of  the  clocked  inverter  'clkinv',  and  the 
devices  'cnand',  'cnor'  and  'cinvert',  can  be  changed  with  'width'  and  'length'  values  and  with 
the  'ratio'  command;  see  section  325  and  NETLIST  User’s  Guide.) 

(5)  A  simple  unclocked  inverter  is  inserted.  The  general  command  for  the  specification  of  this 
CMOS  inverter  is  (clnvcrt  oaf  in),  with  out  and  in  representing  the  names  of  the  nodes  to 
which  the  output  and  the  input  of  the  inverter  are  eonnected. 

(6)  The  second  clocked  CMOS  inverter  is  specified  analogously  to  (4). 


After  completing  the  macro  definition,  save  it  in  the  library  file  libjiet. 

In  the  following  definition  of  the  muter-slave  flip-flop  (see  also  Figure  3b),  you  can  simply  call  the 
latch  by  its  macro  name. 

The  macro  definition  of  the  master-slave  flip-flop  is  analogous  to  that  of  the  latch.  Its  statements,  fol¬ 
lowed  by  the  ezplanation  of  their  meaninp,  are  listed  below: 

i  (1)  MACRO  OEnNinON  FOB  A  CMOS  MAffTBR-SLAVB  FLIP-FLOP 

j  nirr  in  ■:  n  ir  r  i  i  _  ii  i  t'  _  . 

;  (2)  NAMING  THE  MACRO  AND  ITS  PARAMETERS 
(uaera  usTr  (oat  M  d) 

:  (3)  DECLARATION  OF  THE  NODES  LOCAL  TO  THE  FLIP-FLOP 
(local  ■!  ol) 

;  (4)  FIRST  LATCH 
(latch  at  la  cl  a2) 

;  (S)  SECOND  LATCH 
(latch  aat  at  al  cl) 

:  (fi)  CMOS  INVERTER 
(clavut  a2  d) 

;  (7)  CLOSING  PARENTHESIS  FOR  THE  MACRO 

) 

Most  of  the  statements  in  this  macro  definition  will  already  be  familiar  to  you.  Note  that  the  previ¬ 
ously  defined  macro  Hatch'  is  used  in  the  ume  way  u  other  circuit  elements.  If  you  had  not  defined 
the  latch  yourself,  you  might  not  even  know  whether  Hatch'  is  a  macro  or  a  buic  NETLIST  function. 
This  property  allows  you  to  define  successively  more  complex  building  blocks  and  nevertheless  use 
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them  with  the  same  ease  as  the  'primitive*  functions. 

As  we  did  with  the  macro  definition  for  the  latch,  we  now  add  the  macro  definition  for  the  master* 
slave  flip-fiop  to  our  library  file  UbJtei.  It  must  be  inserted  after  the  latch,  since  it  uses  'latch*  as  a  cir¬ 
cuit  element  and  will  therefore  call  the  *Iatch*  macro. 


3  J  J.  Making  the  Register  with  Macros  from  the  Library  •  Loops  and  Indexed  Symbols 

Looking  at  Figure  3c,  it  is  now  easy  to  make  the  ten-bit  (or  any  number  of  bits)  shift  register  by 
chaining  ten  of  the  flip-flops  defined  in  our  macro  library  libjiet.  We  could  write  down  the  call  for 
'mafT  with  the  appropriate  parameters  ten  times,  but  NETLIST  has  the  facility  of  a  loop  and  indexed 
symbols,  which  makes  the  specification  of  such  repetitive  elements  as  the  flip-flops  of  the  shift  register 
very  compact.  (In  accordance  with  the  file  name  conventions,  write  the  following  network  description 
into  a  file  named  shift  Jiet.): 

;  (1)  CIRCUIT  DESCRIPTION  FOR  THE  Ifi-BIT  SHIFT  REGISTER 

•  —  tai.  I  j  ■■■.ir  111  ■-Tvva.aa..iiiT««  ^ 

:  (2)  LOADING  THE  FUNCTIONS  FROM  THE  MACRO  LIBRARY 
(lead  *llbJicO 

;  (3)  NODE  DECLARATION  FOR  THE  NETWORK 
(Beds  hi  eat  cl) 

;  (4)  LOOP  CALLING  THE  MASTER-SLAVE  FLIP-FLOP  10  TIMES 
(repeat  1  1  10 

(auff  eatJ  eat.(-  1  1)  cl) 

) 

;  (5)  ASSIGNING  AN  ADDITIONAL  NAME  TO  THE  INDEXED  NODE  OUT4I 
(ccBBcct  la  aat.O) 


(1)  This  is  the  usual  title. 

(2)  Load  the  macro  library  libnet,  which  has  the  effect  of  inserting  the  macro  definitions  for  latch 
and  nuff  before  the  description  of  the  shift  register. 

(3)  Declare  the  network  nodes  to  which  you  want  to  refer.  Remember,  there  are  two  kinds  of 
node  declarations:  global,  as  here  and  in  the  example  of  the  inverter  (section  3.1);  and  local,  as 
in  our  macro  definitions. 

(4)  This  part  illustrates  two  new  facilities  which  we  have  at  our  disposal  when  we  want  to  q>ecify 
the  description  of  network  structures  that  contain  the  same  sub-circuit  repetitively. 
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In  most  cases  of  such  network  structures,  as  in  our  shift  register,  the  regular  pattern  of  sub¬ 
circuits  makes  it  possible  to  refer  to  their  nodes  with  a  collective  name  followed  by  an  index. 

out.O,  out.l,  out2,  ...,  out.lO  (see  Figure  3c)  are  examples  for  Indexed  node  names,  'out'  is 
the  collective  node  name  for  a  group  of  nodes  having  a  similar  function  or  position  in  the  net¬ 
work;  ’JBT.,  '.r,  ...  are  the  indices  uniquely  identifying  each  of  the  individual  nodes. 

Note  one  other  application  of  indexed  nodes  in  the  'node'  command  of  (3).  Indexed  nodes  can 
be  declared  by  simply  declaring  their  collective  node  name.  It  is  not  necessary  to  list  each  indi¬ 
vidual  node.  Thus,  our  declaration  of  'out'  in  (3)  represents  outJO,  out.l,  out2,  out.lO. 

Generally,  an  index  can  be  represented  by  any  symbol  or  expression.  In  the  'repeat'  loop,  it  is 
given  as  'i'  and  '(-  i  1)',  respectively.  (-  i  1)  is  the  LISP  form  of  subtracting  1  from  i, 
and  just  one  example  of  how  an  index  can  be  calculated  from  an  expression. 

The  symbolic  index  enables  os  to  use  a  loop  calling  our  master-slave  flip-flop  ten  times.  A  loop 
hu  the  format 

(repeat  loop-index  start-value  end-value 
body  of  the  loop 

) 


The  'body  of  the  loop'  can  be  any  sequence  of  commands.  The  loop  in  (4)  starts  with  the  index 
'i'  set  to  1.  'i'  is  increased  by  1  after  each  call  to  the  flip-flop.  In  this  way  the  loop  specifies 
flip-flops  with  connections  to 

out.l,  out  JO,  cl 
out.2,  out.l,  cl 
outJ,  out  2,  cl 


out.lO,  out.9,  cl 

After  'i'  has  reached  the  value  10,  the  loop  is  exited.* 


(S)  The  network  description  using  'repeat'  and  indexed  nodes  looks  very  compact,  but  a  few  nodes 
were  designated  cumbersome  names.  Rather  than  using  the  name  'out.V  for  the  input  to  the 
shift  register  (see  Figure  3c),  we  will  call  it  'in'.  This  can  easily  be  accomplished  with  the  con¬ 
nect  command,  which  equates  the  names  'in'  and  'outi)'.  Another  application  for  the  eonncct 
command  is  in  connecting  two  or  more  nodes  electrically. 


*  Upoa  leaviBg  the  loop,  the  value  of  tbe  tynbol  of  the  loop  indei  will  be  reatored  to  the  value  it  bad  be¬ 
fore  eatering  tbe  ’repeat*  form. 
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3 Processing  the  Shift  Register  Description  File  with  NETLIST  and  PRESIM 

You  should  be  familiar  with  the  procedure  for  processing  a  description  file  with  NETLIST  and 
PRESIM,  from  section  32.1.  However,  be  aware  of  one  additional  file  created  by  NETLIST.  This  file 
is  called  an  alias  file  and  it  contains,  for  each  node,  all  the  different  symbolic  names  that  have  been 
assigned  to  that  node.  Remember  that  you  specified  explicitly  with  the  (connect  In  oot31)  statement 
that  the  names  *in*  and  *outiy  were  to  denote  the  same  node. 

The  alias  file  created  by  NETLIST  has  the  same  main  name  as  the  other  files  related  to  the  network, 
which  is  shift  for  the  shift  register,  followed  by  the  extension  jil.  A  short  explanation  of  the  shiftal 
file  is  given  in  the  appendix. 

Substitute  'shift*  for  'example'  in  the  file  names  from  Figure  1.  (You  have  already  prepared  the  file 

shift  Jiet.) 

Then  enter: 

wnctllst  shlftmet  shlft.stni  <CR> 

This  will  cause  NETLIST  to  process  the  network  description  file  shift  jut  in  the  same  way  as 
explained  before  for  the  inverter. 

(Feel  free  to  inspect  the  shift  Jim  file  produced  by  NETLIST,  which  should  not  be  difficult  since  you 
know  how  interpret  jim  files  from  the  example  inverter  jim  analyzed  in  the  appendix.) 

To  process  the  description  file  with  PRESIM  enter: 

%  prcstm  shift  Jhn  shift  eonflg  <CR> 


PRESIM  gives  you  the  following  information: 

VwWaa  4.3 

IJfaadw;  transtotars;  afe^llS  tatriask-S  law-pawar^  pallaf-t  nknw^ 

TMal  maUaUn  Wtwlaalad  •  23S 

It  is  very  much  similar  to  the  case  of  the  inverter  except  that  the  shift  register  circuit  is  much  bigger. 


You  have  now  seen,  for  several  examples,  how  to  produce  the  network  description  needed  by  RNL. 
The  next  section  examines  a  special  aspect  of  network  descriptions  (converting  network  descriptions 
to  macros).  You  may  want  to  skip  this  now,  and  proceed  to  actual  simulations  of  two  of  the  networks 
we  have  described  so  far. 


32.4.  Converting  a  Network  Description  Into  ■  Macro 
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You  have  seen  how  to  use  macros  as  building  blocks  in  the  description  of  a  network.  A  network 
description  can  easily  be  turned  into  a  macro  in  the  following  way: 

Specify  as  parameters  the  nodes  you  want  to  access  when  you  call  the  macro.  In  the  example 
below,  (output  in  cl)  are  the  parameters  for  the  output,  input  and  clock  connections.  Later, 
before  you  call  the  macro,  you  must  'globally*  declare  (with  the  'nodes'  command)  the  actual 
names  for  the  req>ective  nodes. 

•  Declare  the  remaining  nodes  as  local  nodes.  Be  careful  not  to  use  names  that  are  to  be  used  as 
global  node  names  in  the  'main*  network.  In  the  example  below,  the  indexed  name  'o*  is  used 
to  represent  all  the  individual  indexed  nodes  oB,  o.l,  0.2,  ...,  o.lO  (formerly  outJO,  out.l, 
oot2,  ...,  out  .10). 

Here  is  the  listing  of  a  possible  macro  definition  for  the  ten-bit  shift  register,  derived  from  the  shift 
register’s  network  description: 

;  (1)  MACRO  10-BIT  SHIFT  REGISTER 

;  THIS  MACRO  MAY  BE  CALLED  ONLY  WHEN  THE  'LATCH*  AND 
;  *MSFF*  MACROS  HAVE  BEEN  DEFINED  OR  LOADED 
;  PREVIOUSLY. 

;  (2)  MACRO  DEFINITION 
(macro  shlftrcK_10  (ootpnt  la  cl) 

;  (3)  NODE  DECLARATION  FOR  THE  NETWORK 
(local  o) 

;  (4)  LOOP  CALLING  THE  MASTER-SLAVE  FLIP-FLOP  10  TIMES 
(repeat  1  1  10 

(msff  oJ  o.(-  I  1)  cl) 

) 

:  (5)  ASSIGNING  AN  ADDITIONAL  NAME  TO  NODES  o.O 
;  AND  o.lO 

(connect  In  oB) 

(connect  output  o.l0) 

:  CLOSING  PARENTHESIS  FOR  THE  MACRO. 

) 


After  defining  the  macro,  you  can  add  it  to  the  library  llbjtet  and  use  it  in  the  same  manner  as  you 
have  used  'latch'  and  'msff*. 


UW/NW  VLSI  Release  2.1 


^  17- 


04/18/85 


UW/NW  VLSI  Consortium 


NETLIST  &  RNL  Tutorial  for  Beginners 


SJ  Slatat  of  NETLIST  Functions  with  Two  or  More  Transistors  (CINVERT,  CLKINV,  etc.) 

In  section  32.1  the  NETLIST  functions  'cinvert*  and  'clkinv'  were  used  to  define  the  macros  'latch' 
and  'msfT.  We  did  not  specify  any  gate  siaes  there,  so  the  default  values  were  assumed.  You  will  see 
here  what  the  default  values  are  and  how  they  can  be  changed. 


In  NMOS  functions,  such  as  inverters,  NANDs,  NORs,  etc.  (represented  by  the  NETLIST  functions 
'invert*,  *nand*,  'not*)*  each  individual  transistor  can  be  identified  by  the  node  to  which  its  gate  is 
connected.  This  is  either  one  of  the  input  nodes,  or,  in  the  case  of  the  depletion-mode  pull-up  transis¬ 
tor,  the  output  node  (since  the  gate  of  a  depletion-mode  pull-up  is  connected  to  its  source,  which  is 
the  output).  You  can  specify  the  gate  size  for  each  transistor  by  q>ecifying  width  and  length  together 
with  the  node  to  which  the  gate  is  connected  in  the  following  manner: 

(invert  (out  width-o  length-o)  (in  aridth-i  iength-i)) 

(nand  (out  width-o  length-o)  (ini  width-1  length-1)  (in2  width'2  length-2)  ...). 

Thus,  (invert  (out  4  6)  (in  8  10))  creates  an  NMOS  inverter  whose  enhancement-mode  pull-down 
has  a  gate  area  of  8  by  10  lambda,  and  whose  depletion-mode  pull-up  has  a  gate  area  of  4  by  6  lambda. 
The  case  is  similar  for  the  'nand*  and  the  'nor*,  the  only  difference  is  that  you  have  more  than  one 
input.  The  default  gate  sizes  are  2  by  2  lambda  for  an  enhancement-mode  transitors  and  2  (width)  by 
8  (length)  lambda  for  a  depletion-mode  transistor. 


In  CMOS  devices  the  situation  is  different.  Normally  an  input  connects  to  two  gates  >  one  gate  of  a 
p-channel  transistor  and  one  gate  of  an  n-ehannel  transistor.  This  makes  the  sizing  specifications 
somewhat  more  complicated,  since  a  node  does  not  any  longer  uniquely  identify  an  individual  transis¬ 
tor.  NETLIST  permits  you  to  specify  width  and  length  together  with  a  node  as  in  the  NMOS  case, 
e.g.. 


(cinvcrt  out  (bs  width  length)) 

However,  these  values  detennine  only  the  g»tc  width  and  length  of  the  n-channel  tranristor  and  the 
gate  length  of  the  p-channel  translator.  Defaults  are  2  lambda.  You  can  set  the  width  of  the  p-channel 
translator  to  a  multiple  of  the  width  of  the  n-channel  transistor  with  the  command 

(ratio  value) 

which  must  precede  the  function  it  is  to  affect.  For  example, 

(ratio  3) 

(cinvert  out  (in  4  6)) 

sets  the  'ratio'  for  'cinvert'  (and  all  following  CMOS  functions  until  the  next  'ratio'  conunand  is 
encountered)  to  3.  The  n-channel  transistor  (pull-down)  of  the  inverter  gets  a  gate  area  which  is  4 
lambda  wide  and  6  lambda  long.  The  the  p-channel  transistor  (pull-up)  gets  a  gate  area  which  is  3  *  4 
«  12  lambda  wide  and  6  lambda  long. 

The  default  'ration  is  2. 

If  a  node  connects  to  only  one  gate,  width  and  length  of  the  gate  area  are  set  in  the  same  manner  as 

*  We  did  Bot  uw  iben  bat  coBcentrated  ob  CMOS  fuBcdoBi.  If  yov  wbbI  to  kBow  more  about  tbesi,  aee 
tbe  NETLIST  Uaer’a  Guide. 
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described  above  for  NMOS.  Thus,  in  the  case  of  a  docked  inverter,  you  can  spedfy  the  dimensions  of 
the  gate  area  of  the  two  transistors  conneded  to  the  input  node  in  the  same  manner  as  in  the  case  of 
'cinvert*,  whereas  the  dimensions  of  the  two  transistors  whose  gates  are  connected  to 'd'  and  *cl-'  are 
specified  independently: 

(ratio  3) 

(dkinv  out  (in  4  6)  (cl  8  10)  (cl*  12  14)) 

The  gate  dimensions  of  the  two  transistors  forming  the  inverter  are  the  same  as  in  the  'cinvert*  above. 
The  gate  area  of  the  p-channel  gating  transistor  connected  to  *d>*  is  12  lambda  wide  and  14  lambda 
long,  the  gate  area  of  the  n-channel  gating  transistor  conneded  to 'd*  is  8  lambda  wide  and  10  lambda 
long. 

The  sizes  of  the  other  CMOS  functions  available  in  NETLIST  are  sd  in  a  similar  manner  (see  NET- 
LIST  User’s  Guide). 


4.  CIrcnIt  SImnlatloa  with  RNL 


RNL  can  take  its  command  diredly  from  the  user’s  keyboard  or  from  a  file  or  a  mixture  of  both. 
There  is  a  certain  amount  of  information  that  must  be  supplied  all  the  time:  which  standard  libraries 
should  be  used,  which  network  to  read,  where  to  store  the  result  of  information  if  that  is  desired 
(most  of  the  time)  etc.  Then  the  timing  or  pattern  information  must  be  added.  In  most  situations  you 
want  to  deate  a  file  with  all  standard  simulation  set-up  information  (which  we  will  call  the  "control* 
or  "J"  file)  and  another  file  which  is  called  by  a  command  in  the  control  file  containing  all  the  timing 
information  of  signals  to  be  applied  to  the  circuit  under  test.  It  may  be  of  interest  to  first  exercise  the 
circuit  in  the  fully  interactive  way  as  shown  in  sections  4.1  and  42.  A  number  of  utilities  have  been 
designed  which  will  allow  unsophisticated  users  to  define  set-up  files  and  pattern  files  without  having 
to  worry  about  li^  syntax  at  dl.  These  utilities  are  discussed  in  section  43.  It  is  not  necessary  to 
work  through  sections  4.1  and  42  to  have  sufficient  understanding  for  working  on  section  43. 


4.1.  Interactive  Command  Input  and  Batch  Command  Inpot 

You  have  now  completed  all  the  necessary  preparations  to  run  a  simulation  of  one  of  the  circuits 
described  previously.  We  will  run  RNL  and  start  out  with  our  simple  inverter. 

•  ml  <CR> 

RNL  comes  up  with  its  version  number 

VtnlM4.2 

and  waits  at  the  beginning  of  the  next  line  for  your  command  input.  (RNL  does  not  have  prompting 
sign.)  Every  command  you  enter  now  is  immediately  executed  and,  if  necessary,  commented  by  RNL. 
This  is  why  this  mode  of  operation  is  called  the  interactive  mode.  Correq>ondingly,  this  way  of  enter¬ 
ing  commands  is  called  interactive  command  input.* 

*  Just  in  ease  yoe  warn  to  eail  RNL,  the  comnaod  to  leave  RNL  in  aa  orderiy  faabtoa  ia  (wit)  or  simply 
aWt. 
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Before  starting  on  your  simulation,  you  must  load  the  two  files  uwstdJ  and  uwsimJ  ,  containing  func¬ 
tion  definitions  for  RNL. 


(load  *awstdJ*)  <CR> 


(load  'owsliB  <  CR> 

Laodlag  owitaBj 
0«B«  iMdiat  owriBj 

(The  loading  of  the  mwstdl  file  is  implied). 

Next,  load  the  binary  network  description  file  inverter. 

(read-network  'Inverter*)  <  CR> 

RNL  will  prompt  with  information  about  the  network: 

:  •■•dM;  trmiilan:  tatriaOc-e  o<kaa^  law  peww-0  pallap-0  nalalar>0 


There  is  a  simple  command  ("S'  •  we  will  use  it  shortly)  to  run  a  simulation  step  for  an  amount  of  time 
defaulted  to  100  ns.  To  change  this,  a  variable  incr  can  be  set.  incr  *  0.1  ns  is  the  new  length  of  the 
of  the  simulation  step.  For  example,  an  Incr  of  10  results  in  a  simulation  step  length  of  1  ns.  The 
command  to  assign  a  value  to  a  symbolic  variable*  is  (setq  symbol  vaina). 

Let  us  carry  out  the  simulation  in  steps  of  one  nanosecond.  Set  Iner  to  10  so  that  the  product  of 
'incr*  and  the  internal  step  width  is  1. 

(sctd  Incr  10)  <CR> 

la 

RNL  echoes  (returns)  the  value  assigned  to  Incr. 


Frequently  it  is  convenient  to  refer  to  a  group  of  nodes,  rather  than  to  one  individual  node.  You  can 


*  Strictly  ipcakias.  ’iaetf  is  a  LISP  cynbol.  Symbols  in  LISP  are  not  quite  tbe  saaw  as  variables  ia  other 
programmiog  laBguages.  Ia  maay  cates  however,  u  with  'ioci',  they  act  Just  like  'coaveatioaal'  variablea. 
We  therefore  will  frequeatly  dcsigaate  as  variables  objects  which  should  strictly  be  called  symholt. 
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denote  a  symbolic  name  for  a  list  of  node  names  with  'setq*.  We  will  give  the  name  'nodes*  to  the 
list  of  the  two  nodes  'in'  and  'out'. 

(sctq  nodes  ’(in  mO)  <CR> 

Oa  «M) 

Again,  RNL  returns  the  value  it  assigned  to  the  variable,  which  is  the  list  (in  out). 


The  final  step  is  to  specify  details  for  the  reports  on  the  simulation  step.  There  are  two  standard 
report  forms  available  in  RNL. 

The  first  type  of  report  lists  the  state  of  nodes  whenever  this  state  changes.  We  want  to  obtain  such  a 
report  for  the  changes  in  our  'nodes',  i.e.  'in*  and  'out*.  Each  node  has  a  'chaoge>Sag*  telling  RNL 
that  such  a  report  is  requested.  For  a  list  of  nodes  (nl,  n2, ...),  this  'change-flagf  is  set  with  the  com¬ 
mand  (chflag  ’(b1  n2  ...)).  Since  we  have  already  defined  a  list  of  nodes  (in  out),  named  *node^,  we 
can  enter 


(chflag  nodes)  <  CR> 

t 

RNL  has  now  set  the  change-flags  of  'in*  and  'out*  to  'true*. 


The  second  type  of  report  lists  the  state  of  nodes  at  the  end  of  a  simulation  step.  To  obtain  such  a 
report  on  the  nodes  'in*  and  'out',  use  the  'def-report*  command: 

(def-report  ’('STATE  AT  END  OF  SIMULATION  STEP:*  In  out))  ^CR> 
rSTATB  AT  END  or  SIMULATION  STET:*  Im  eW) 

The  capitalized  text  in  quotes  is  the  title  of  the  report.  It  is  followed  by  the  names  of  the  nodes  that 
are  to  be  included  in  the  report. 


Now  try  a  simulation.  Setting  the  input  of  the  inverter  to  high  potential*  is  simply  done  by  entering 
h  In  <CR> 


*  We  will  frequeoily  refer  to  high  poleatial  w  Hi|b,  end  Co  low  potential  aa  Low. 
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RNL’s  reply  4mw  means  that  it  carried  out  your  command.  (From  now  on,  we  will  not  mention  this 
'done'.) 

”h*  is  the  mnemonic  for  High,  followed  by  the  name  of  the  node  to  be  set  to  Hig^.  (You  can  qjecify 
more  names,  separated  by  a  blank). 


Ron  a  simulation  step  by  entering  the  mnemonic  a  : 
a  <CR> 

In  accordance  with  your  specifications  in  'chflag*  and  *def>report*.  RNL  will  reply: 

Star  kiflM  •  •  M. 

STATl  AT  END  OF  SIMULATION  STEP: 

Camat  Ha*"  1 
ta«l  rat^ 

After  starting  up  RNL,  the  starting  time  for  a  simulation  is  always  set  to  zero,  so  your  first  simulation 
step  begins  at  0.  The  reports  on  changes  in  the  states  of  the  nodes  *in*  and  'out*  show  that  'in*  was 
set  to  High  at  time  zero,  and  that  'out*  changed  to  Low  at  0j6  ns.  This  is  exactly  what  an  inverter 
should  do.  The  time  delay  in  the  change  of  the  output  is  caused  by  the  time  needed  to  load  the  gate 
capacitance  of  the  inverter  and  the  time  needed  to  unload  the  output  node  capacitance  of  Oj03  pF  (see 
3.1.1).  The  report  at  the  end  of  the  simulation  step  tells  you  that  the  time  is  now  1  ns,  and  repeats 
the  state  of  the  nodes  'in  and  'out*,  as  required  in  the  *def>report*  command.  (For  other  com¬ 
mands  to  run  a  simulation  step  see  RNL  User’s  Guide). 


Now  consider  another  state  of  the  inverter,  set  the  input  to  Low  (n*  is  the  mnemonic  for  Low): 

1  In  <CR> 
and  do  a  simulation  step: 

■  <CR> 


I 


i 

k 

k 

w' 

v' 

c 

w 


fwp  kilMs  •  1  as. 

M-aai 

Ml*!  •  aA 

STATE  AT  END  OT  SIMULATION  STEPi 
CamM  Um'I 
la*S  aat*! 

The  report  given  by  RNL  is  analogous  to  the  one  just  explained.  This  time  the  simulation  starts  out 
at  1  ns  with  the  input  set  to  Low.  The  output  changes  to  High  at  0.6  ns  (relative  to  the  starting 
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point  of  the  simulation  step),  again  the  delay  is  caused  by  the  gate  and  output  capacitances.  At  the 
end  of  the  simulation  step  the  time  is  2ns,  *in*  is  Low  and  'out'  is  High. 


RNL  uses  three  different  logic  states  to  characterize  the  potential  of  a  node.  They  are: 

High,  symbolized  H,  with  the  value  1.  Logic  high  is  assumed  whenever  the  simulated  voltage 
level  of  the  node  is  between  a  high  threshold  and  1. 

Low,  symbolized  L,  with  the  value  0.  Logic  low  is  assumed  whenever  the  simulated  voltage 

level  of  the  node  is  between  0  and  a  low  threshold  . 

Undefined,  symbolized  X.  An  undefined  state  is  assumed  whenever  the  nmulated  voltage  level  of 
the  node  is  between  a  low  threshold  Vim  and  a  high  threshold  a  high  threshold  . 

You  can  set  any  node  to  one  of  the  three  states  with  the  following  commands: 

h  Set  the  node  to  High  (shown  above). 

1  Set  the  node  to  Low  (shown  above). 

u  Set  the  node  to  Undefined. 

Setting  a  node  in  this  way  has  the  effect  of  connecting  the  node  to  a  voltage  source  with  zero 
impedance,  thus  overriding  any  other  value  the  circuit  might  try  to  impoae.  Nodes  with  their  values 
fixed  in  this  way  are  called  input  nodes  (because  they  are  used  like  an  input  to  a  circuit,  and  RNL 
internally  puts  them  on  an  'input  list*).  They  will  stay  at  the  assigned  logic  level  until  you  release 
them.  You  release  nodes  with  the  command  z,  followed  by  the  names  of  the  nodes  you  want  to 
release.  After  the  node  has  been  released,  it  is  free  to  assume  whatever  level  it  wants  to  assume 
naturally  in  the  circuit  (it  will  assume  this  level  after  an  's'  command  is  executed). 


The  simple  example  of  the  inverter  has  given  you  a  good  idea  of  how  to  'operate'  RNL  in  interactive 
mode  :  You  enter  a  command  and  receive  an  immediate  reply.  Now  exit  RNL  to  prepare  a  'batch' 
command  file: 

edt  <CR> 

« 

You  are  back  with  UNIX. 


There  is  one  other  mode  of  RNL  operation  which  we  shall  call  batch  mode.  You  can  write  any 
sequence  of  RNL  command  into  a  file  and  specify  the  name  of  this  file  u  a  parameter  when  you  start 
RNL.  We  will  call  this  file  'RNL  command  file',  or  simply  command  file.  You  will  almost  always 
want  to  have  such  a  command  file  to  save  yourself  the  work  of  keying  the  'load',  'read-network',  and 
other  commands  that  are  invariably  needed  to  set  up  the  proper  conditions  for  a  simulation. 
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To  see  how  the  conunand  file  is  used,  write  the  first  seven  of  the  above  commands  into  a  file 
inverter  J: 

(load  *uwstdJ*) 

(load  'owsimJ*^ 

(read-network  'inverter*) 

(setq  incr  10) 

(setq  nodes  ’(in  out)) 

(chflag  nodes) 

(def-report  ’('STATE  AT  END  OF  SIMULATION  STEP."  in  out)) 


Now  run  RNL  again,  with  the  command  file  inverter  J  as  a  parameter: 

«  ml  inverterJ  <CR> 

You  will  get  almost  the  same  replies  as  before  when  you  entered  the  commands  interactively.  (The 
only  difference  is  that  returned  values,  such  as  the  10  in  (setq  incr  10),  are  not  shown.) 

Now  set  the  input  High  and  run  a  simulation  step,  then  set  the  input  Low  and  run  another  simulation 
step.  Again,  you  will  get  the  same  answers  as  before. 

In  order  to  set  up  the  proper  conditions  for  a  simulation,  most  commonly  one  starts  out  with  the  exe¬ 
cution  of  the  commands  from  a  command  file  and  then  continues  in  interactive  mode.  RNL  LISP  pro¬ 
grams  for  time-consuming  simulations  may  be  developed  in  interactive  mode,  written  into  a  command 
file,  and  later  run  in  batch  mode. 

We  will  do  the  simulations  of  the  shift  register  in  this  mixed  way  in  the  next  sections. 


4J.  Practicing  RNL  Simulations  •  The  Shift  Rcglttcr 

You  can  modify  on  the  command  file  prepared  in  the  previous  section  and  use  the  modified  file  when 
we  start  up  RNL  for  the  simulation  of  the  shift  register.  Write  the  following  modified  commands  into 
the  file  shift  J  : 

(load  'uwstdJ*) 

(load  'uwsimJO 
(read-network  'shift*) 

(setq  incr  100) 

(setq  nodes  ’(in  out  .10  cl)) 

(chfiag  nodes) 

(def-report  ’('STATE  AT  END  OF  SIMULATION  STEP.'  in  out.l0  cl)) 

Now  run  RNL  again  with  sh^tJ  as  the  start-up  comnund  file: 

%  ml  shlftJ  <  CR> 
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RNL’s  reply  is  similar  to  the  one  discussed  in  the  previous  section. 


Let  us  do  some  initializing  and  propagate  input  through  the  shift  register  (  (1)  through  (17)  ). 


(1)  Initialize  the  network 
(sim-lnit) 

S2 


When  you  start  up  RNL,  the  state  of  the  nodes  is  Undefined,  i«.  neither  High  bot  Low. 
This  state,  symbolized  'X',  is  not  very  useful  at  the  outset  of  a  simulation.  It  is  preferable  to 
start  with  a  definite,  stable  state.  Tlie  (sim-init)  command  tries  to  help  you  with  this.  It 
returns  the  number  of  all  Undefined  nodes  and  then  sets  them  to  Low.  In  this  case,  S2 
nodes  were  set  to  Low.  If  the  number  of  nodes  set  to  Low  was  not  0,  you  should  do  a  simu¬ 
lation  step  and  propagate  the  new  values  throu^  the  network  (we  will  do  that  in  (2)).  If  this 
leads  to  Undefined  node  values  again,  do  another  (sim-init). 

Repeat  the  sequence  of  (sim-latt)  foUewcd  by  a  almnlatlon  step  nntll  (slas-lnit)  rctnms  0.  If 
you  cannot  settle  the  network  in  this  way  after  four  to  five  repetitions,  RNL  might  not  been 
able  to  simulate  your  design  properly  (for  example,  if  a  an  input  signal  and  a  feed-back  signal 
derived  from  this  input  simultaneously  drive  a  node).  In  such  cases  refer  to  section  four  of 
the  RNL  User’s  Guide. 


(2)  Simulation  step  to  propagate  the  nodes  set  to  Low 

s 


Stop  bmiai  •  • 

Mt.M-1  m 

•oUtHI  m  9-4 

ITATB  AT  END  OF  mWULATION 
Ounut  IS 
ia^  aut.lS~S  cl^ 


As  a  result  of  propagating  the  Low  nodes  from  the  previous  (sim-init),  'out.lO*  changes  twice 
during  the  simulation  step.  The  reports  are  analogous  to  the  ones  explained  in  the  previous 
section. 
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(3)  Next  initialization  step. 

(sloi-inlt) 

0 

This  time  the  number  of  nodes  set  to  Low  by  (sim-init)  was  0,  i«.,  the  network  had  been 
settled  to  a  stable  state  with  the  commands  in  (1)  and  (2). 


(4)  Simulation  step  to  propagate  the  nodes  set  to  Low. 

a 

Stoa  btfiM  #  IS 

STAn  AT  END  OF  SIMULATION  STEP: 

Carat  ttea-  3S 
ia^  aat.ta-a  cl-« 


As  expected,  no  changes  occurred  in  this  step  (no  nodes  were  changed  in  the  previous  (sim> 
init)).  Reports  as  usual. 


(S)  Give  a  name  to  a  group  of  nodes. 

(actq  all_nodcs  ’(in  oat.l  ontJ  ootJ  *01,4  ent4 
oat.6  9ut.7  obU  •ot.f  oat.10)  ) 

(M  ('•tran-  aat  1)  ('«tract-  aat  3)  (-ctract-  aat  3)  (■alracV  aat  4  )  (-alnct*  aat  5)  (•■tract-  cat  S)  (-Bract-  aat  7) 
( Biact»  aat  •)  (-atract-  aat  f)  (.atract-  aat  IS)) 

We  give  the  name  'all.nodesT  to  the  group  af  nodes  forming  the  shift  path.  RNL  returns  its 
internal  representation  of  this  list  of  nodes. 


(6)  Set  the  change-  flag  for  the  group  of  nodes, 
(chflag  all_BOdes) 
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(!■  (-atnMl*  OTl  1)  (-ctract-  Mt  2)  (-cinct*  sM  3)  (•«i«ct>  4  )  (-itract-  aat  S)  (••lr«c^  4)  (-Unicl-  7) 

(-■Inct*  Mt  ■)  (-ftract*  mi  t)  (-atnut*  sat  !•)) 

This  command  sets  the  change-flag  for  each  node  of  8ll_Bodca. 

We  could  have  used  the  command 

(chflag  ’(in  out.l  out2  out3  oot.4  out^ 
out.6  out.7  out^  outJ9  out.lO) 

) 

to  achieve  the  same  result,  but  instead  used  the  symbol  aUjtodes  to  give  an  example  of  the 
usage  of  a  name  for  a  group  of  nodes. 


(7)  Set  the  clock  input  to  Low. 
I  cl 


s 

Stq>  begia*  6  20  os. 

STATK  A.T  END  Of  8IMU1AT10N  STEV: 

Omat  tlM>  3t 
OTt.M*S  cl-i 

d«M 

The  clock  is  set  to  Low,  followed  by  a  simulation  step.  Reports  as  usual. 


(8)  Set  all  nodes  in  the  shift  path  to  High. 

(repeat  1  •  M 
(h  ’(oat.(eTal  I))) 

) 

M 


B 

ftsf  •  M 


UW/NW  VLSI  Release  2.1 


-27- 


04/18/8S 


UW/NW  VLSI  Consortium 


NETLIST  &  RNL  Tutorial  for  Beginners 


Mt.M-1  m  • 

nu-i  m  • 

OTtJ-l  « • 

m  • 

OTt^-l  « • 

Mts*!  m  • 

Mt4-1  « • 
mU'I  m  > 
mu«i  m  • 
mu-1  m  • 
bi-iaa 

STATE  AT  END  OS  SIMULATION  STEF: 
Camat  Itea-  4S 
lB-1  aat.M«l  cl«« 


The  repeat  command  is  similar  to  the  one  in  section  i22,  where  it  was  used  to  make  a  shift 
register  from  ten  ms-flip-flops.  Of  course,  the  body  of  the  loop  is  different  here.  It  is  the 
command 

(h  *(oot.(cval  i))). 

There  are  several  peculiarities  in  the  form  of  this  command  (which  you  have  already  seen  in 
its  simpler  forms,  e.g.  h  out.l). 

RNL  LISP  has  a  syntax  simplification  which  permits  you  to  write 
command  argoment_l  argomcnt_2  argDment_3  ... 
instead  of 

(command  ’(ar|omcnt_l  argnmcnt_2  ar|nment_3  ...)) 

Therefore,  h  ont.lO  is  equivalent  to  (b  *(OBt.l0)). 

However,  the  simplified  syntax  may  not  be  used  if  the  command  is  part  of  another  command, 
such  as  inside  the  'repeat*. 

The  (aval  I)  is  needed  because  RNL  does  not  evaluate  a  symbol  if  it  is  preceded  by  an  apos¬ 
trophe  O-  (aval  I)  returns  the  value  of  *i*,  which  varies  from  1  to  10. 

Since  we  set  the  change-flag  for  *all_nodek’,  RNL  reports  all  the  changes  in  the  correspond¬ 
ing  nodes’  values,  followed  by  the  usual  final  report  at  the  end  of  the  simulation  step. 
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(9)  Apply  one  clock  cycle 

b  cl 


I 

Stop  ktgiM  41  u. 

STATK  AT  END  OF  SIMULATION  STEF: 
carnal  Una-  M 
la-1  mLU-I  el-1 


I  Cl 

daa* 


■ 


Stop  biglae  e  SS  ae. 
d^«S 

STAn  AT  END  OF  SIMULATION  STEF: 
carnal  Uw-  M 
ia-1  mI.M-1  cl-t 


We  set  the  clock  first  to  High,  then  to  Low,  each  time  followed  by  a  simulation  step.  This  is 
equivalent  to  a  clock  cycle  of  the  leng:th  of  two  simulation  steps. 


(10)  Release  all  nodes  in  the  shift  path. 

(repeat  1  0  10 
(a  ’(OBt.(eval  1))) 

) 

le 


s 
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Slav  kiglBS  6  M  u. 

STATE  AT  END  OF  SIMULATION  STEP: 
Cairat  tlm*»  71 
tai-1  cl=f 


Recall  that  we  have  set  all  the  nodes  in  the  shift  path  to  High  (8),  which  is  equivalent  to  con¬ 
necting  them  to  Vdd.  By  setting  them  to  *x*,  we  enable  them  to  assume  whatever  state  they 
may  naturally  go  to  in  the  course  of  the  simulation.  Thus,  the  ’repeat”  loop  releases  all  the 
nodes  in  the  shift  path  of  the  register. 


(11)  Set  input  to  Low. 

I  in 


s 

Stair  9  7S  aa.  laHI  9  • 

STATE  AT  END  OP  SIMULATION  STEP: 
Catrait  ttaM«  • 
tiHI  cl=0 


With  the  previous  steps,  all  the  ceils  of  the  shift  register  have  been  set  to  a  state  of  High. 
Now  we  set  the  input  to  Low  in  order  to  later  watch  this  Low  signal  shift  through  the  regis¬ 
ter. 


(12)  Shift  the  Low  input  for  one  clock  cycle 

h  el 


s 

Step  begioa  @  80  ni. 
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cl>t«« 

STATS  AT  END  OT  SIMULATION  STEP: 

OlfMt  Um-  N 
ia^  Mt.M-1  d>l 


s 

attf  «  M  M. 
d-sat 
OTLl-S  •  M 

STATE  AT  END  OF  SIMULATION  STEP: 
CailHt  tte«-  IM 
aat.lt-1  d-« 


!  OBt.l  OOtJ  ontJ 

mU-L  (d-«JI  tk-MI)  (•4DS4M  pf)  ^MtK 

taipat  to  fsacltai  ftr  tfct  toltowtot  m4w: 

IS 

IS 

S 

S 

tolU'D  (d«SJ«  Th-f  JS)  (•4M4H  pf)  afftolsi 
tepat  to  fMacttaai  far  ik*  ftltowtap  ■■Swi 
XI 
XI 

3S 

SI 

•■L34  (d-IJI  vk-«JI)  (IMIN  pf)  MTactoi 

kipat  to  fkacttaa*  far  tk*  faUaatop  aaStot 

$9 

SP 

as 

32 


One  clock  cycle  shifts  the  Low  from  the  input  to  the  output  of  the  first  register  cell.  At  the 
end  of  the  clock  cycle  we  use  the  I  (exclamation  sign)  command  to  check  the  values  of  the 
first  three  cells  of  the  register. 
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!  provides  the  values  of  the  specified  nodes,  their  logic  thresholds  (normalized  to  1),  and 
their  capacitances.  Next  it  provides  the  names  of  all  nodes  to  which  the  nodes  specified  with 
!  are  inputs.  In  the  example,  these  node  names  are  numerical.  The  numerical  node  names 
were  assigned  by  NETLIST  to  nodes  inside  the  shift  register.  They  were  not  declared  in 
shifiJtet  but  came  with  the  *latch*  and  ”msfr  macros.  (If  you  want  to  know  more  about 
them,  you  have  to  scrutinize  shift Jtm.) 

(  ?  (question  mark)  is  a  command  similar  to  ! .  It  provides  information  about  transistors  for 
which  a  node  is  either  gate  or  source,  and  about  the  sum-of-products  representation  of  the 
node.  See  RNL  User’s  Guide  for  more  information.) 

Using  !  (and  ?),  you  can  'walk*  through  the  network  and  check  node  values  and  connec¬ 
tions. 

The  listing  produced  by  I  shows  that  the  Low  input  has  moved  to  *out.r,  as  it  should  have 
after  one  clock  cycle. 


(13)  Shift  the  input  a  second  clock  cycle. 

h  cl 

d«M 


s 

Stop  hi|la*  #  IN  as. 
d-l«S 

STAn  AT  END  OF  SIMULATION  STEP: 
Camat  ttaas-  lit 

lB>«  aat.lS-1  d'l 


I  d 


Stssksdas  •  lllat. 
d-C«S 
aaU^  •  S.S 

STATE  AT  END  OP  SIMULA110N  STEP: 
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(14) 


Cairait  cl*C 


I  oot.l  ootJ  00(3 


otU'L  (vi-oji  Tk-«M) « J3S4M  po  irr«iR 

tapat  to  r«MU«n  far  tka  fallairtait  oadaai 
IS 
15 

t 

■ 


aoU>L  (vl>SJP  Tk^JO)  pf)  affaetB 

lipol  to  faacttaoa  far  Ika  raUaartag  aaOaat 


n 

XT 

as 


aiMJ4 

topotto 

SP 

S» 

SI 

sa 


<al-«JO  «k-iJi)  (P.P3MPP  po  aft) 
rnctlaoa  far  Ika  fallairtai  oaOaa: 


Reports  analogous  to  (12).  The  Low  input  has  now  moved  to  'oot2”. 


Shift  the  Low  input  a  third  clock  cycle. 


h  cl 


s 


Stop  kaKM  •  US  aa. 

ci-l«S 

STATB  AT  END  OF  SIMULATION  STIP( 
COmat  ttato*  US 
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d°l 


1  d 


Stof  k*|lM  S  IM 

d-««t 

•at  m  M 

STATS  AT  END  OT  SIMULATION  STSTt 
Oimat  tiM«  I4S 
ia^  aat.IS*!  d*d 


I  oat.l  oat^  oatJ 

•atl-L  (d-«  Jl  «k-S.M)  (•  J3S4M  pT)  iffsetK 

lapatia  faactloai  far  ika  faSawtas  aaSaa: 

U 

U 

S 

I 

aaU^  (dTajp  Tk-SJS)  (•.•3S4N  pf)  affaetR 

lapat  la  faacllaaa  far  ika  faUawtag  aadaai 

37 

37 

31 


aaU-L  (Tl-f  JS  «k-SJf)  (•.•3MM  pf)  afracta 

lapat  la  faacllaaa  far  Ika  fallavlap  aadaa: 

3P 

JP 

at 

at 


Reports  tnslogous  to  (12).  The  Low  input  hu  now  moved  to  *oat3”. 
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(IS)  Do  seven  more  clock  cycles  to  shift  the  Low  input  completely  to  the  end  (out.lO)  of  the  shift 
register. 

(repeat  I  1  7 
(h  XcD) 

(•  ’(*)) 

(I  ’(CD) 

(■  ’(«)) 

) 

Stsf  kiflH  •  MS  u.  cl-l  •  S  STATE  AT  END  OT  SIMULATION  STEP:  Cemet  liew  IN  ie-S  Mil.lO=l 
d-l 

SlieSwNsN  INm.  cI^  •  Seeld-eAS^  state  at  end  op  simulation  STEP:  Cemal  Em*  ms 
aat.lS-1  d*d 

Sdv  btslM  0  MS  d>l  •  S  STATE  AT  END  OP  SDOJLATION  STEP:  CUmal  ITS  ta^  MiUS«l 
d«l 

sup  S«de*  0  ITS  M.  d^  0  S  Nt.S^  0  SJ  STATE  AT  END  OP  SIMULATION  STEP:  CBmM  EM-  IN 
Mt.lSol  d-S 

Sl«p  k««lM  0  MS  d«l  0  S  STATE  AT  END  OP  SIMULATION  STEP:  Oimat  Ew»-  IN  la-S  mUS-I 
d-1 

Sup  0  IN  M.  d^  0  S  0  S.S  STATE  AT  END  OP  8IMDLATION  STEP:  Onmt  Em-  3M 

iB««  OTt.lS-t  d-S 

Sttf  kiliH  0  MS  M.  d-1  0  S  STATE  AT  END  OP  SIMULATION  STEP:  CUntaS  Esm-  SIS  la-S  aaUS-l 
d-1 

Stop  kWN*  0  SIS  a*.  cl-S  0  S  aat.T^  0  S3  STATS  AT  END  OP  SIMULATION  STEP:  CEmat  Em-  SSS 
la>«  aal.M-l  d-S 

Stop  k««lai  0  SM  as.  d-1  0  S  STATS  AT  END  OP  SIMULATION  STEP:  Camat  Em-  SN  ia-S  aaLlS-l 
d-1 

Stop  b«0at  0  SM  aa.  d^  0  S  auLS-S  0  SJ  STATS  AT  END  OP  SIMULATION  STEP:  CEmat  Eaa-  SSS 
la-«  aat.lS-1  d-S 

Stop  kiflaa  0  SN  aa.  d-1  0  S  STATS  AT  END  OP  SIMULATION  STEP:  Caniat  ttaa-  SN  ia^  aaLlS-l 
d-1 

Stop  badda  0  SN  aa.  d-S  0  S  aaLtN  0  SJ  STATS  AT  END  OP  SIMULATION  STEP:  CEmal  Eaw-  SN 
laN  aal.lS-1  d-S 

Stop  htplm  0  SN  aa.  d-1  0  S  STATS  AT  END  OP  SIMULATION  STEP:  Canaat  Itea-  SN  la-S  aat.lS-1 
d-1 

Stop  badaa  0  SN  aa.  dN  0  S  aaLN-S  0  SJ  STATS  AT  END  OP  SIMULATION  STEP:  CEmal  Em- 
SM  la>e  aat.lS-S  d^ 


7 
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(The  rimulation  report  is  printed  more  compactly  here  to  save  space.  Otherwise  it  is  analo¬ 
gous  to  the  reports  in  (12)  through  (14)).  At  the  end  of  each  clock  cycle  the  Low  input 
appears  shifted  one  more  cell  toward  the  output.  After  the  last  clock  cycle,  it  has  reached 
•out.l(r. 


(16)  Define  a  clock  function  with  the  number  of  eyelet  as  a  parameter.  The  function  is  called 
'cycles'. 

(def an  cycles  (a) 

(repeat  11a 
(h  •(cl)) 

(s  '(*)) 

(I  *(el)) 

(a  ’(a)) 

) 

) 


'defun'  is  one  of  the  most  useful  functions  in  RNL  LISP.  It  enables  you  to  define  your  own 
functions  that  can  subsequently  be  used  in  the  same  straightforward  way  as  all  other  RNL 
functions,  'cycles'  illustrates  this  point,  'defun'  is  followed  by  the  name  you  give  the  func¬ 
tion,  which,  in  turn,  is  followed  by  a  list  of  parameters  representing  the  arguments  to  the 
function  (see  also  (1‘^).  The  body  of  the  function  definition  is  made  up  of  other  functions  or 
sequences  of  functions.  In  the  case  of  'cycles',  the  body  of  the  function  definition  is  a 
'repeat'  loop  that  is  to  be  iterated  a  times.  In  the  next  paragraph  you  see  how  easily  one  can 
specify  a  sequence  of  a  clock  cycles  with  this  newly  defined  function.  (RNL  has  a  clock 
function  'c',  which  you  could  have  used  instead.  We  defined  our  own  clock  function  here  in 
order  to  illustrate  the  power  of  'defun'.  Another  important  function  for  you  to  explore  with 
the  help  of  the  RNL  User’s  Guide  is  'do'.) 


(17)  Set  the  input  to  the  shift  register  to  High  and  propagate  it  through  the  shift  register  for  four 
cycles,  using  the  'cycles'  function.  Then  look  at  the  outputs  of  latches  3,  4,  and  S. 

h  In 


(cycisi  4) 

•tap  bnSsf  •  an  n.  cl>l  0  S  ta«l  •  a  fTATX  AT  IND  OF  SIMULATION  STEP:  CamM  Uwf  3N  la*! 
aat.lS-a  cl'l 
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[18) 


Stav  A  1.3  STATE  AT  END  OF  SIMULATION  STEF:  Camnl  300 

ta*!  d>S 

Stav  U0m  0  3N  d«l  A  •  STATE  AT  END  OF  SIMULATION  STEP:  Cnnwt  310  !■=!  rat.lOM 
d-1 

Stap  baoMs  A  31S  M.  d-«  A  S  aM  J«1  A  1.3  STATE  AT  END  OF  SIMULATION  STEP:  CUrrat  tiaa-  330 
■■•1  OTt.lO«d  d^ 

Stap  kaplM  A  330  M.  d*l  A  ■  STATE  AT  END  OF  SIMULATION  STEP:  Canal  daw-  330  ta-1  aal.lO-O 
d-1 

Slap  bagtaa  A  330  aa.  d-0  A  •  mI.3-1  A  1.3  STATE  AT  END  OF  SIMULATION  STEP:  CBnaal  dwa-  340 
ia-l  nLIO^  d-0 

Slap  kagtaa  A  340  aa.  d-1  A  S  STATE  AT  END  OF  SIMULATION  STEP:  Carnal  Itea-  3S0  ia-l  •al.10-0 
d-1 

Slap  kaptat  A  3N  aa.  d^  A  •  at.4-1  A  1.3  STATE  AT  END  OF  SIMULATION  STEP:  Carnal  dwa-  3M 
la-1  OTLlO^d-O 


4 


t  MtJ  Odt.4  MtJ 

aaC3-B  (d-dJO  ah-O JO)  <OJ3MOO  pC)  aftadai  tapal  la  taaadaaa  far  Ida  IiWaalad  aadaa:  30  30 

S3  33 

aaU-H  (d^JO  rk-OJO)  (0J3S4O0  pT)  affwla  lapal  la  faaedaaa  far  lha fdlaal^  aadaa:  fl  SI 

44  44 

aaU-L  (d«<J0  ak-OJO)  (0J30400  pO  aWacIa  lapal  la  faaedaaa  far  dw  fdlaaiao  aadaa:  O  S3 

SO  so 


At  the  end  of  (16),  all  the  cells  in  the  shift  register  were  at  Low.  After  setting  the  input  to 
High  and  appl)ring  four  clock  cycles,  the  High  input  should  have  arrived  at  *out.4*.  The 
function  'cycles*  made  it  very  easy  to  apply  the  clock  cycles.  The  result  is  as  expected. 


Open  a  log-file  to  record  the  activities  of  the  RNL  session.  Define  a  node  veetor  and  change 
the  report  at  the  end  of  a  simulation  step  using  the  vector. 
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(log-fUc  '•hlftJog') 


I 

(dcfTcc  ’(bio  path  lo  oot.l  oatJ  aatJ  aat.4  ont^ 

oat4  aat.7  ontJ  oat.9  eot.lO)) 


(kia  palb  <aad*ia>H>  <BSd*Mt2-R>  <Bad*MU~H> 

<B«4tMt4>H>  <Bad*aBt.S>*L>  <Bt4»aBt^»L>  <Bad»aBl.7*L> 
<B«dt«itA>L>  <B«4««at.9*L>  <B«4*«Bt.M«L>) 


(dcf-rcport  ’('State  of  Shift  Path: '  (vce  path))) 

ratal*  if  Skirt  Palk: '  (Mb  patk  <B*d*  !*•«>  <Bada  aatl>H> 
<Bada*BtJ-ll>  <BadaaBtJ*H>  <Bada*Bt4-B>  <B*a**aU*L> 
<B*daaBl.(»L>  <B*d**at.7«L>  < Bad* *BtJ««L>  <Bad*aBt.9«L> 
<b*4*  *Bt.ie«i,> )) 


I 

Slap  kapiBt  •  3M  B*. 

Staia  M  Skirt  Palk: 

Camat  Him*  371 

patk-skinitaaeaM 

The  ”Iog-fiIe'  command  has  the  effect  that  the  file  shift  Jog  is  opened  and  that  all  subse¬ 
quent  terminal  activities  will  be  recorded  in  this  file.  You  can  later  analyze  this  file  or  edit  it 
to  keep  parts  of  your  interactive  RNL  session  for  inclusion  in  a  control  file  (J  file).  The 
number  returned  is  the  file  identification  (ID)  of  shift  Jog.  You  can  close  the  log-file  with  the 
command  (log-file  nil).  Alternatively,  the  log-file  will  automatically  be  closed  when  you  exit 
RNL  (we  will  close  the  log-file  in  this  way). 

The  'defvec”  command  defines  a  data  structure  ealled  a  vector.  A  vector  is  a  list  of  nodes. 
The  value  of  a  vector  is  determined  by  the  value  of  its  nodes.  For  example,  if  a  vector  has 
three  nodes  with  the  values  0, 1,  0  (Low,  High,  Low),  the  value  of  the  vector  would  be  010 
binary,  or  2  decimal.  There  are  a  number  of  commands  operating  on  vectors,  e.g.  amigning  a 
value  to  a  vector  (see  RNL  User’s  Guide).  The  vector  definition  has  the  format  (defvec 
’(base  name  node_l  node_2  node_3  )).  *base*  is  the  base  of  a  number  system  and 
can  be  bin  for  binary,  oct  for  octal,  hex  for  hexadecimal,  and  dec  for  decimal.  When  the 
value  of  the  vector  is  printed,  it  is  given  u  a  number  with  the  base  given  in  *base*  (see  ”def- 
report*  below),  'name*  is  the  symbolic  name  of  the  vector,  which  is  'path*  in  the  example. 
*aode_r,  *node_2',  'node_3',  are  the  nodes  of  the  veetor.  In  the  example  they  are  'in', 
*out.l*,  'out2*,  ...  The  list  returned  after  'defvecT  is  the  internal  representation  ^  the  vec¬ 
tor. 


The  'def-report*  specifies  a  new  format  for  the  report  at  the  end  of  a  simulation  step,  thus 
overriding  the  ”def-report*  given  in  the  shift  J  file  (however,  this  does  not  influence  the 
reports  on  value  changes  of  nodes  marked  with  'chflag*).  With  (vec  path)  you  specify  the 
inclusion  of  the  vector  'path*  in  the  report  (for  more  variations  of  the  *def-report*,  see  RNL 
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User’s  Guide).  A  simulation  step  following  the  report  definition  illustrates  the  new  report 
format.  Since  the  base  given  in  "defYec*  is  binary,  the  vector  is  printed  as  a  binary  number. 
The  first  two  characters,  Ob,  indicate  the  base  (they  would  be  0  for  octal.  Ox  for  hexade¬ 
cimal,  and  none  for  decimal).  The  binary  vector  representation  provides  a  good  'visual'  pic¬ 
ture  of  the  shift  path.  The  input  and  the  first  four  cells  are  High,  the  other  cells  are  Low. 


(19)  Open  a  file  to  store  RNL  output  ('behavior'  file)  for  subsequent  printing  on  a  Printronix 
printer.  Then  shift  an  input  signal  through  the  shift  register  and  exit  RNL.  (The  RNL  out¬ 
put  in  the  'behavior'  file  will  be  analyzed  with  the  program  MTP). 


apcaplot  'Alftiich' 


llB 

(cycim  1) 

htai 

(cyclaa  1) 

llB 

(cyclaa  1) 
(cyclaa  10) 


calt 

After  the  file  has  been  opened  with  the  'openplot*  command,  information  on  all 

nodes  whose  change-flag  is  set  will  te  stored  in  this  file  until  the  file  is  closed  with  'closeplot*. 
Terminating  RNL  with  'exit'  will  automatically  close  the  file,  in  which  case  no  'closeplot'  is 
needed,  ('openplot'  returns  'nil*  after  opening  the  plot  file.  The  reqwnses  for  the  com¬ 
mands  following  'openplot*  are  reports  similar  to  those  already  discussed  and  have  therefore 
been  omitted  in  the  above  text.) 

Recall  that  we  set  the  change  flag  for  *node^  with  the  control  file  shtftJ.  Later  we  interac¬ 
tively  set  the  change-flag  for  *all_nodes'.  Therefore,  information  on  the  following  nodes  will 
be  stored  in  shift  ^h: 

in  cl  out.l  out2  oot3  out .4  out3 
oot.6  out.7  out3  out.9  out.lO 


UW/NW  VLSI  Release  2.1 


-39- 


(M/18/85 


UW/NW  VLSI  Consortium 


NETLIST  &  RNL  Tutorial  for  Beginners 


To  obtain  a  signal  that  can  be  easily  identified  in  the  printout,  we  apply  a  pulse  at  the  input 
of  the  shift  register  by  setting  the  input  Low.  High,  and  Low  again,  each  followed  by  a  clock 
cycle.  Then  we  shift  this  pulse  through  the  register  with  ten  more  clock  cycles.  With  the  last 
command  we  exit  RNL. 


43.  Defining  Control  and  Stlmolos  Flics  the  *Eosy*  Way. 

The  definition  of  control  files  for  RNL  is  generally  much  more  difficult  than  defining  netlists  for  cir¬ 
cuits.  The  reason  is  that  many  more  lisp  commands  are  necessary  in  the  definition  of  control  files.  Two 
programs  have  been  defined  to  substantially  reduce  the  need  of  understanding  lisp,  although  the  user 
may  benefit  from  understanding  lisp.  The  first  program  is  called  ’GEN_CONTROL’.  It  is  intended  to 
create  a  set-up  file  for  a  circuit  using  answers  to  the  questions  asked  by  this  program.  It  formats  the 
answers  so  that  the  output  file  can  be  read  by  RNL. 

The  second  program  is  called  *GEN_TIME*.  This  program  uses  a  description  of  patterns  in  a  very  sim¬ 
ple  format,  without  the  poisonous  lace  of  parentheses  and  quotes  and  creates  an  output  file  which  can 
be  called  by  the  control  file  created  with  the  genjcontrol  command. 

A  couple  of  conventions: 

GEN_CONTROL  will  create  a  control  or  *.T  file:  'basauuneV. 

It  expects  a  network  by  the  name  of  'basename'. 

Results  will  be  stored  in  the  ’basename Jog’  file  . 
and  the  information  for  plotting  is  stored  in  the 
’basenasneheh’ 

Furthermore,  the  pattern  information  file  will  have 
the  name  ’basename Jime’. 

By  the  way,  the  user  will  be  prompted  for  the  actual  ’basename’  name. 

GEN_TIME  will  use  the  ’basename  Jtim’  file  as  an  input  file  and  create  a  ’basename  Jbne’  output  file. 


43.1.  IMng  GEN_CONTROL  to  Generate  a  Control  File. 

Assume  you  created  the  shiftregister  defined  in  section  323.  and  you  have  the  network  file  "skiff. 
Now  run  in  the  same  directory: 

%  gcn_control  (no  arguments). 

The  req>onse  is: 


ItwatUf  QwwitlM  at  cootnl  flat  tar  KNL. 

vw/vun  ooNsonnuM  vusion. 

ruiawi  MtaOaM  amwad  :  T.  ’mum’.  ’Jog’ 

The  first  prompt  is  for  the  basename  of  the  circuit;  GEN_CONTROL  will  assume  the  conventional 
extensions  as  discussed  before.  Each  response  to  the  prompt  is  terminated  with  a  <CR>.  In  this 
case  type: 

shift<  CR> 

The  second  prompt  is  for  a  comment  line  to  be  included  in  the  control  file  for  identification 
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purposes: 


*EBUr  ny  c«a 


■t  liM  (M  cfeanctcn  jm  wMl: 


For  example  type: 

this  is  I  shiftregister  test  circuit<CR> 

The  third  prompt  is  for  the  duration  of  every  simulation  step  in  0.1ns  units. 

■Xatar  Ik*  tta*  teal*  far  riaalallaa  la  aallK 
torr-' 

For  example  respond  with:  1000<  CR> 

The  fourth  prompt  is  a  definition  of  nodes  to  be  defined  as  a  unit  in  a  vector.  Vector  definitions  are 
used  in  the  def-report  and  allow  the  user  to  print  the  state  of  clusten  of  nodes  in  a  very  compact 
manner.  Note  that  its  only  use  is  for  state  reporting  purposes  at  the  end  of  a  simulation  step.  It  has  no 
impact  on  the  reporting  on  intermediate  changes!  Let  us  define  a  vector  called  'state'  with  nodes 

out.l  out2 _ out.l0.  The  type  of  this  vector  is  simulation).  By  the  way.  the  type  definition  only 

affects  the  format  of  the  report  generated  by  RNL;  it  does  not  require  that  you  use  the  same  format 
when  using  *invec’!  The  prompt  is: 

*Dirw*  layai  vwMn  la  imaari  firww,  if  My. 

B*aly  wllk  <CB>  It  m  (wan)  SifMltoM  rawiitiS. 

VacMMM*  •* 

So  respond  with: 

state<  CR> 

the  prompt  then  is  for  the  type: 

•Vmut  lyp*  (Mi/fciB/«cl/aM/kM)  •  * 

So  respond  with: 
bit<CR> 

the  next  prompt  is  for  the  nodenames  in  the  vector: 

*llMMti  *1  Ik*  T*et*r  SWIsMm  (no  k*  iaSlvMsil  B*d*  a*w), 

■fa**4  SM  MaakwM*  apart: 
a«4«i  la  vaclar  •  * 

respond  with: 

out.l  out.2  out  J  out.4  out  J  out.6  out.7  outB  out.9  out.lO<CR> 

Now  you  will  be  prompted  again  for  a  vector  definition: 

*V*(t*tBn*-' 

There  is  nothing  more  to  define,  just  respond  with: 

<CR> 

Now  you  will  be  allowed  to  define  vectors  in  a  simplified  fashion;  for  example  the  vector  ‘state’  if 
it  eould  be  re-baptized  in  ’out’  can  be  easily  defined  as  a  single  indexed  vector,  with  starting 
index  ‘1’  and  number  of  elements  ‘10’  and  the  function  will  assume  vector  elements  out  .10 

...jOUt.l. 


Since  we  already  typed  in  the  vector  in  the  standard  way,  we  will  ignore  this  option  and  type 
<CR>. 

Getting  even  more  sophisticated,  we  can  use  double  indexing  of  nodenames  and  create  several 
defvec’s  all  at  one  time.  So  a  set  of  vectors  are  to  be  defined  v_l  ....  v_n  (note  no  periods  in 
names  of  vectors!)  with  nodenames  vi.l  through  vizn  is  easily  accomplished  by  properly 
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responding  to  ttie  prompts  for  type,  btsename  and  values  for  n  and  m. 

This  option  is  not  appropriate  in  this  example  and  we  type  again  <  CR> . 

Next  you  will  be  prompted  for  the  format  of  the  report  you  want  RNL  to  provide.  There  are  in 
fact  two  independent  type  of  reports  generated;  one  relates  to  the  state  of  the  network  at  the 
end  of  a  simulation  step  and  the  other  to  intermediate  changes  occurring  in  the  network.  The 
answer  to  this  prompt  will  only  affect  the  report  at  the  end  of  a  simulation  cycle.  The  report 
includes  comments  to  be  printed,  nodenames  to  be  reported  on  and  vectomames  to  be  reported 
on.  The  comment  comes  first,  nodes  and  vectors  in  any  sequence  of  choice.  This  format 
definition  must  always  be  present  in  an  RNL  definition,  otherwise  you  may  not  get  any  reponse 
at  all  from  running  a  simulation!  The  prompt  is: 

tk*  aMpal  aaSw  rapwltS  by  KNL  (nesliiSI) 
l■l■ct  rnmtiri  lyp*  by  f«p«Sfaia  wllb  <€■> 

Mart  tsSiStyps  by  flip ■StstwUb  <Mycbir>  <ai> 


There  can  be  two  types  of  reports  selected,  one  which  is  straight  a  set  of  nodenames  and  vectors 
and  the  other  which  allows  sets  of  ectors  to  be  defined.  We  ignore  this  latter  option  and  type 
<CR>. 

•Emim  MWMt  Um  (ir  ay)  * 

First  respond  to  the  request  for  a  comment: 
response  *•  <  CR> 

(just  <  CR>  is  fine  if  no  comment  is  desired) 

The  next  prompt  is: 

*ISatfry  th*  aadauai  ad  vwioraaM  to  b«  npwtod. 

Is  raw  «f  t  v«tor,  typt  *fw'  ad  ym  will  b*  ptaiptod  tor  Ito  baa. 

Typaaadaaw  «<?«':* 

Now  reqyond  to  the  request  for  node  and  vector  names  to  be  reported  on;  we  would  like  to 
show  ’cl’  and  ’in’: 
cl  in<CR> 

The  prompt  becomes  again: 

*Typ«  •  aadaaM  «r  'r«c' :  * 

since  we  still  have  the  vector  state  to  be  included  in  the  report  format  definition  wc  type: 
vcc<  CR> 

GEN_CONTROL  now  asks  for  the  vectomame: 

*Nawvator  •  ' 

respond  urith  the  name  of  the  vector  state 
state<CR> 

The  program  then  asks  for  additional  vector  or  nodenames: 

*Typ»  a  aadaaaa  ar  'vac' : 

Since  we  are  done,  we  terminate  the  prompting  for  the  report  format  by  typing: 

<CR> 

Next  we  are  prompted  for  logic  analyzer  style  output.  If  affirmative,  a  lot  of  extra  text  is 
removed  from  the  output  report  from  RNL  and  the  output  becomes  pretty  much  tabular.  For 
example,  instead  of  printing  ’cl-0’  only  *0’  is  printed.  RNL,  before  generating  any  output,  will 
automatically  print  the  order  by  which  the  reported  states  appear.  The  prompt  is: 
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*D«  jm  wtak  U  VKlfy  logic  nolTar  ntpal  (■•  »  <CS> )  T  ' 

We  respond  by: 
y<CR> 

Next  we  are  prompted  by: 

*D* TOT  wtsb  to  tan  OB  gUlck  eotoctiM  (Ba-<ai>)?* 

If  affirmative  than  the  nodes  which  we  will  identify  in  the  following  prompt  will  only  be 
reported  if  they  are  subject  to  more  than  one  change  in  state  during  a  simulation  cycle. 

Let  us  turn  this  on  too  (later  try  what  happens  if  you  leave  it  off): 
y<  CR> 

Now  we  are  getting  to  the  definition  of  the  second  type  of  report  which  can  be  generated  by 
RNL:  reporting  of  intermediate  changes  in  qiecified  node  states.  When  a  node,  which  nodename 
was  included  in  the  ’chflag’  list,  changes  state:  its  name  and  time  of  change  is  reported  either  in 
relative  time  (default)  or  in  absolute  time  units.  However,  if  the  glitch-detection  has  been  turned 
on,  this  only  occurs  if  the  node  changes  more  than  once;  the  latest  change  is  the  one  that  is 
reported. 

Let  us  at  least  (with  the  glitch-detection  on)  report  any  glitches  on  the  nodes  indentified  in  our 
response  to  this  prompt: 

out.l  out.2  outJ  out.4  out J  out.6  out.7  outR  out.9  out.lO<  CR> 

GEN_CONTROL  comes  back  with  a  prompt  for  reporting  intermediate  changes.  Like  in  the 
case  of  defvec’s  we  can  enable  individual  nodes  to  be  defined  or  sets  of  single  indexed  nodes  or 
even  sets  or  double  indexed  nodes.  We  do  not  select  this  option  here  so  only  single  nodenames 
are  entered. 

The  prompt  is: 

*IMW«  tte  BBdw  witk  trudOTti  la  npartad. 

N«dw  COT  te  dtOBid  iBdiTMaaDT, 

kj  SINGLE  INDEXED  vwtor  ar  DOUBLE  INDEXED  vactan 

Tjpa  aada  bmc.  Vac',  ’fact’  ar 

<  CX>  If  (aa  aara)  aad«  la  ka  dWIaad. 

Ealar  aada  aaaa,  ‘aac*  ar  >ad'  (ar  <CX> ) :  * 

Let  us  enter  just  the  nodes  straight: 

out.l  out2  out3  out.4  out3  out.6  out.7  outR  out.9  out.lO<CR> 

The  next  prompt  is: 

'Caatiaaa  wItk  MlrMaal  aadaBamaar  a  <CX>  :* 

Terminate  prompting  for  nodenames  by: 

<CR> 

The  next  prompt  again  is: 

*XBtar  aada  ana,  ‘aac’  ar  Vacl'  (ar  <  €■> ) : 

Respond  with:  <  CR> 

Another  option  available  in  RNL  is  define  a  logic  trigger  condition,  at  which  time  you  execute  com¬ 
mands  in  a  special  file.  We  do  not  select  this  option  and  we  type  <  CR> . 

We  may  want  to  define  additional  simulation  set-up  commands  like  print  a  message  or  whatever  (now 
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you  get  into  lispi)  (if  you  do  not  want  anything  just  type  a  <  CR>  );  the  prompt  for  this  is  as  follows: 

*ir  dMind,  tjrp«  addlUtaai  rfmaJalia  SET-UP  canMd  Ubm: 

(If  mat:  Jait  typ*  <  Clt> ;  nma  iftw  Haw  hava  bwa  taland)' 

We  respond  by  asking  that  an  announcement  be  printed  when  RNL  has  loaded  all  files  and  starts  the 
actual  simulation: 

(printf  'Let  us  start  simulating  now  ..An  ”)<  CR> 

There  is  no  other  prompt  until  we  terminate  the  loop  by  typing  another: 

<CR> 

Next  we  are  prompted  for  a  timing  information  file: 

*Da  jraa  wUh  la  ipacif jr  a  Aifttiwa  Na  (aa  -  <  CB> )  T  * 

Most  of  the  time,  also  in  this  case,  you  want  one  generated  by  GEN_TIME. 

Respond  with: 
y<  CR> 

(In  fact:  any_character<  CR>  will  do; 
just  a  <  CR>  means  no) 

Finally  there  is  a  prompt  for  a  wrap-up  command: 

*If  daalrid,  typa  addMaaal  WRAP-UP  RNL  cawaiaad  Maw: 

(if  aat:  jaai  typa  <  CR> ;  ana  aftar  Kata  ha*a  baaa  aataiad)* 

You  can  type  in  the  ‘exit’  command  if  you  want  RNL  to  terminate  immediately  after  executing 
the  instructions  in  the  'jime'  file  (not  recommended)  or  since  we  are  fancy:  a  message  saying 
simulation  complete: 

(printf  ' . simulation  doneKn  *)  <CR> 

exit<CR> 

There  are  no  prompts  until  an  additional  <CR>  is  typed: 

<CR> 

Finally:  GEN_CONTROL  indicates  that  it  is  terminating  and  that  it  has  created  a  control  file 
with  the  name  basenanui  (in  this  case  the  basename  is  ’shift*): 

*CEN_OONTROL  COMPLETED. 

Camet  arran  ia  ibirt.l  attaia  a  ataadard  IM  adttar.' 

You  should  look  at  this  file  with  your  favorite  text  editor  and  make  corrections  using  this  text 
editor  (GEN_CONTROL  does  not  have  any  utilities  for  making  corrections).  You  will  note  that 
all  set-ups  necessary  for  simulation  are  included,  including  the  loading  of  libraries,  reading  the 
network  and  defining  the  report  formats  with  the  proper  syntax  (notice  where  the  quotes  and 
parentheses  goO-  We  have  now  completed  half  of  the  work:  the  definition  of  a  timing  pattern 
remains  to  be  done.  That  is  the  subject  of  the  next  section. 


4J  J.  Generation  of  Stimulus  Pattern  Files. 

Let  us  create  a  file  called  'shift jtim'  using  your  favorite  tc/^  editor.  In  this  file  we  first  have  to  define 
the  number  of  simulation  steps  in  units  of  the  value  of  ‘incr’.  Let  us  assume  we  want  to  run  50  simula¬ 
tion  steps,  starting  at  0: 

The  first  non-comment  line  (comment  lines  start  with  a  semicolon)  contains: 

Next  we  specify  activities  on  the  input  nodes  cl  and  in.  Now  remember  that  the  first  number  after  the 
nodename  relates  to  the  period  of  the  signal  applied  to  that  node.  This  is  also  true  for  vector  type 
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stimulus  (invec  ind  bitinvec).  The  clock  has  to  run  all  the  time,  the  minimum  period  therefore  is  2;  at 
time  0  the  clock  goes  high  and  at  time  1  the  clock  goes  low  again.  The  syntax  is:  nodename  period 
statel  timel  state2  time2  ....  (as  many  state  changes  you  wish  to  define  within  the  period).  A  value 
for  periods  equal  to  0  means  in  reality  infinity:  this  pattern  is  a  one-time  event  cycle.  For  the  clock 
signal  this  means  the  following: 

cl2h0ll 

We  have  to  specify  an  input  pattern  to  in;  let  us  start  with  setting  in  low  at  t  «  0  and  high  at  t  »  IS 
and  back  low  at  t  *  30.  Tliis  results  in  the  folloaring  command  line: 

InOIOhlSiao 

Finally,  we  MUST  define  how  often  we  want  the  state  of  the  network  repotted.  Let  us  assume  we 
want  a  report  every  2  time  increments  at  the  end  of  every  1st  increment  witUn  the  period: 

report  2  1 

(If  you  want  a  report  at  the  end  of  every  simulation  step  you  type:  report  1 0) 

There  are  additional  commands  available  for  applying  vectors,  putting  masks  in  to  create  bursts  of  sig¬ 
nals  and  for  including  normal  lisp  commands.  Refer  to  the  documentation  for  those.  Store  the  file  in 
'shift Jtim'  and  run  the  following  command: 

%  feB_tiiBC  shlft.sUm  shlft4lme 

This  program  terminates  very  quickly.  Please  inject  the  shift Jime  file  created  by  GEN_T1ME.  You 
will  find  that  all  signal  activities  are  sorted  by  time  increment  and  in  a  format  suitable  for  RNL.  In 
fact  the  ’.time*  is  for  control  what  the  *xim‘  file  is  for  a  netlist  description. 

You  are  now  ready  to  run  the  simulation;  the  command  line  is: 

*  ml  shift  J 
see  what  happens! 

Since  we  included  ’exit’  in  the  control  file,  RNL  terminates;  if  we  did  not  include  this  command,  RNL 
would  be  waiting  additional  commands  from  the  keyboard  terminal.  Options  are: 

additional  RNL  commands  (fully  interactive  mode) 

silt  (terminate  RNL  simulation  and  store  the  results  in  'shift Jof 

*Z  to  halt  RNL  to  allow  definition  ot  an  additional  timing  file  to  start  at  the  end 

of  the  current  simulation  cycle  (e.g.  50);  thereafter  you  restart  RNL  with  Tg’ 
and  type:  (load  'sbiftulm*) 

DO  NOT  TYPE  *C  which  will  terminate  RNL,  without  however 
storing  the  results  of  simulation  in  ’diift  Jog’. 


433.  Tytag  AU  the  PrsgraM  Togrthsr  With  a  Makefile. 

We  have  identified  several  ptograins  necessary  to  run  a  complete  simulation.  Rather  than  running 
these  programs  individually  a  very  simple  makefile  can  do  the  same  for  you. 

Remember  that  in  this  section,  source  files  that  do  not  depend  on  outputs  of  programs  are: 

shift jm  tot  the  definition  of  the  netlist  description  and 
shift  jtim  for  the  sttainlus  deaenpeion. 

In  the  concept  presented: 

shift  J  is  generated  in  an  mteracrive  fashion  by  OEN_CONTROL. 

The  rest  is  gencreted  froni  iheae  mpnt  Mca  The  make  program  keeps  tabs  on  when  those  files  have 
been  updated  and  mas  certam  pragrems  agam.  tf  asrsssary.  to  get  a  valid  simulation  result. 

Include  the  aukefik  dMwa  ta  the  appeadia  la  the  seam  directory  along  with  your  other  files  needed 
for  simulatioa.  with  a  test  eduor  ta  rgc  aiahcfilc  nihstinitc  N  •  whmtvtr  with  N  >  shift  (or  another 
circuit  baaenamc).  Back  la  the  eats  r'  •<!  type 
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%  Bake 

and  all  missing  files  will  be  generated  and  if  the  source  files  are  not  present,  it  will  tell  you  so. 
There  are  certain  arguments  you  may  give  to  do  only  a  portion  of  the  generation  of  necessary 
simulation  files.  Refer  to  the  summary  command  list  in  the  index. 


4.4.  FrlBtiag  RNL  Oatpot  Usliig  MTP 

The  program  MTP  has  been  developed  for  printing  the  output  of  RNL  simulations  on  the  Printronix 
dot  matrix  printer.  MTP  stands  for  Multiple  Time-series  Rot.  From  the  behavior  file  produced  by 
RNL  at  the  end  of  the  last  section  a  printout  of  the  signals  can  be  obtained  in  three  steps.  You  have 
to  (a)  create  a  file  containing  directives  for  MTP,  (b)  create  a  plot  file  and  (c)  send  the  plot  file  to  the 
Printronix  printer. 

(a)  MTP  has  been  designed  to  plot  a  number  of  different  kinds  of  behavior  files  in  a  number  of 
different  formats.  However,  for  the  purpose  of  plotting  the  output  of  RNL  only  a  few  direc¬ 
tives  need  be  supplied.  These  are  the  following 

START  time 

The  START  directive  tells  MTP  when  to  start  plotting  (in  nanoseconds).  If  not  supplied 
its  default  value  is  0.  Data  is  skipped  on  the  behavior  file  until  an  event  is  found  whose 
time  is  greater  than  or  equal  to  the  START  time. 


STOP  time 

The  STOP  directive  tells  MTP  when  to  stop  plotting  (in  nanoseconds).  STOP  has  no 
default  value  and  must  be  supplied.  If  the  STOP  time  is  greater  than  the  time  of  the  last 
event  on  the  behavior  file,  the  plot  will  be  concluded  with  the  last  event. 


SCALE  time 

The  SCALE  directive  tells  MTP  how  many  time  units  to  plot  per  inch  on  the  plot 
(nanoseconds  /  inch).  The  default  value  u  lOOB  which  is  an  appropriate  value  for  RNL. 

Signal  selection  and  trace  format  directives 

MTP  does  not  plot  every  signal  in  the  behavior  file  but  only  those  that  are  specifically 
requested.  This  permits  experiments  which  generate  a  large  number  of  traces  to  be 
analyzed  selectively.  MTP  provides  several  trace  formats  which  can  be  used  for  analog 
and  data  domain  values  but  the  simplest  and  most  useful  for  RNL  is  the  LOGICAL  for¬ 
mat.  To  select  signals  A,  B  and  C  for  plotting  in  LOGICAL  format  the  necessary  MTP 
directives  are 


Logical  A 
Logical  B 
Logical  C 

The  order  of  the  traces  on  the  plot  is  determined  by  the  order  of  the  selection  directives 
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(b) 


in  the  file.  The  first  signal  selected  is  plotted  closest  to  the  time  axis.  There  can  be  a 
maximum  of  20  signals  selected  on  a  given  plot. 


All  MTP  directives  are  case  insensitive  except  for  signal  names  and  are  free  field,  separated  by 

blanks  or  CR. 

For  our  example  write  the  following  into  a  directives  file  named  MftMr: 

START  0.0 
STOP  700.0 
SCALE  100.0 
LOGICAL  In 
LOGICAL  el 
LOGICAL  oat.l 
LOGICAL  oot  J 
LOGICAL  aQt.3 
LOGICAL  oat.4 
LOGICAL  oot  J 
LOGICAL  oatA 
LOGICAL  oat.7 
LOGICAL  aot  J 
LOGICAL  OQt.f 
LOGICAL  aot.l0 


To  create  the  plot  file,  which  is  to  get  the  name  shift enter: 

«aitp  sUftJich  shlftAlr  ■Uft.plol  <CR> 

MTP  will  provide  information  on  its  progreu  and  echo  the  content  of  the  directives  file: 

SWwt  ad  awpwtwi  iaaat  d«s 

STAKTSJ 

STOP  7MJ 

8CAU  lasj 

UKICALcI 

LOGICAL  OTLl 

LOGICAL  aU 

LOGICAL  aO 

LOGICAL  aid 

LOGICAL  otJ 

LOGICAL  aU 

LOGICAL  al.7 

LOGICAL  atJ 

LOGICAL  at.f 

LOGICAL  aLM 

Swi  ynyncMMd  eraW 

GowatetkapM 

Basiitlw  ftr  tto  Piiaaola 

■ip  caipiM,  ptat  ra*  to  lairLplai 
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(c)  To  send  the  plot  file  to  the  Printronix  printer  enter: 


« Ipr  -I  shlft^lot  <  CR> 

This  will  produce  the  printout  shown  on  the  following  page.  No  signals  are  plotted  before  370 
ns  (03700e+03),  since  we  opened  the  behavior  file  only  at  that  time.  Remember,  that  at  this 
time  the  outputs  of  the  first  four  cells  of  the  shift  register  were  High,  the  other  six  outputs 
were  Low.  You  can  see  this  state  of  the  register  move  through  the  output  'out.lO*.  You  can 
also  see  the  input  signal  move  through  the  register  immediately  afterwards. 


5.  Sammary  and  Ontlooh 

The  simulation  of  the  inverter  and  the  shift  register  are  examples  of  what  you  might  encounter  if  you 
attempt  to  model  and  simulate  your  particular  applicmion  with  NETLIST  and  RNL.  We  were  not 
able  to  look  at  all  of  the  commands  available  in  RNL  and  NETLIST,  and  therefore  concentrated  on 
some  of  the  most  frequently  used  ones.  You  will  find  complete  lists  of  coounands  for  both  NETLIST 
and  RNL  in  the  references  listed  in  the  appendix. 

The  LISP'like  command  interpreter  used  by  both  NETLIST  and  RNL  provides  the  facilities,  and 
enables  you  to  create  your  own  special  tools,  for  simulating  very  complex  circuits.  There  are  several 
ways  to  tackle  the  intricacies  of  RNL  LISP.  In  addition  to  studying  the  User’s  Guides,  you  may  work 
through  examples  of  elaborate  simulations,  such  as  the  simulation  of  the  microcode  sequencer  refer* 
enced  in  the  appendix.  Another  possibility  is  to  have  a  close  look  at  the  function  definitions  given  in 
the  files  KwstdJ  and  uwsimJ.  AIm,  especially  if  you  are  fond  of  languages,  you  may  want  to  study 
LISP  in  its  'pure*  form,  without  commands  particular  to  RNL  and  NETLIST. 

Whatever  you  do,  keep  in  mind  that  RNL  is  a  simulator  based  on  a  model  of  the  real  circuit,  and 
therefore  it  is  wise  to  know  the  assumptions  underiying  the  model  as  well  as  the  limits  of  its  applica¬ 
bility.  Information  about  the  theory  of  NETLIST  and  RNL  is  provided  in  Chris  Terman’s  original 
User’s  Guides  and  his  thesis  referenced  in  the  appendix. 
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Appendix  1  •  Farther  Referencea 

You  may  need  information  from  the  following  sources  if  you  want  to  use  NETLIST  or  RNL  more 
extensively. 

From  UW/NW  VLSI  Consortium,  VLSI  Design  Tools  Reference  Manual: 

1.  NETLIST  User’s  Guide  (Contains,  among  other  information,  a  list  of  all  NETLIST  com¬ 
mands.) 

2.  PRESIM  User's  Guide  (Contains,  among  other  information,  specifications  for  the  eoitfig 
file.) 

3.  RNL  User’s  Guide  (Contains,  among  other  information,  a  list  of  all  RNL  commands.) 
and  in  addition, 

4.  User’s  Guide  to  NET,  PRESIM,  and  RNL/NL,  Christopher  J.  Terman,  MI.T.  Laboratory 
for  Computer  Science. 

5.  Simulation  Tools  for  Digital  LSI  Design,  (Thesis),  Christopher  J.  Terman,  MJ.T.  Labora¬ 
tory  for  Computer  Science. 


fi.  Simulating  a  Microcode  Sequencer  Using  RNL:  An  Annotated  Example  of  RNL  Usage, 
Robert  J.  Fowler,  UW/NW  VLSI  Consortium. 


7.  LISP,  PJI.  Winston,  BXf .  Horn,  Addison-Wesley  Publishing  Company,  1981. 


8.  Metamagical  Themas,  The  Pleasures  of  LISP:  the  chosen  language  of  artificial  intelligence, 
DR.  Hofstatter,  article  in  three  parts  published  in  Scientific  American,  March  and  April 
1983.  RE  I.P 


Appendix  2  •  Description  of  the  jIm  file  ef  the  example  'lavcrter*  (section  3.U). 

The  inverter  Jim  file  produced  in  section  3.12.  contains  the  following: 

I  units:  2SOjOO  tech:  TTt  format:  MIT 
p  in  out  Vdd  SBO  8j00  r  0  0  64JOO 
e  in  GND  out  8jOO  4B0  r  0  0  32XW 
c  out  3BOOOOOe-02 

Lines  beginning  with  a  vertical  bar  are  considered  comments  by  PRESIM,  unless  they  have  an 
entry  'units/’  or  'format/',  'units/'  gives  the  conversion  factor  to  centi-microns.  'format:'  is  one 
of  'MIT*  or  'UCB'  (or,  if  no  format  is  given,  the  old  format  originally  used  by  the  program  is 
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assumed).  *tech:  T!T  is  the  default  comment  indicating  the  technology  used.  You  can  change  this 
conunent  with  the  -t  option  to  NETLIST. 

The  following  explanations  relate  to  the  MIT  format,  since  the  jim  file  of  the  example  has  MIT 
format. 

Lines  2  and  three  specify  a  p^hannel  and  an  e-channel  transistor,  respectively.  Each  of  them  is 
followed  by  the  names  ^  the  nodes  to  which  it  is  connected  (gate,  source,  drain),  by  the  length 
and  width*  of  the  gate  area  in  units  of  lambda,  by  a  geometrical  descriptor  for  the  gate  area 
which  is  always  set  to  r  (rectangular)  by  NETLIST,  by  its  layout  positional  coordinates  (NET- 
LIST  always  specifies  0  0),  and  finally  by  the  gate  area  in  square-lambdu. 

The  last  line  of  inverter  jim  qiecifies  the  output  capacitance  between  out  and  GND,  again  with 
positional  coordinates  given  as  0  by  NETLIST,  and  a  value  of  0.03  pF. 

(For  more  details  on  the  jim  file  formats  read  the  on-line  manual  with  the  UNIX  conunand  man 
5  rimfUe). 


Appendix  3  -  Preparation  of  a  dmple  'config*  file 

The  PRESIM  User’s  Guide  provides  details  on  how  to  prepare  configuration  files.  It  lists  all  the 
possible  parameters  together  with  their  default  values.  Generally,  you  need  different 
configuration  files  for  different  technologies.  Since  we  use  a  p-channel  transistor,  we  need  to 
use  the  configuration  file  to  tell  PRESIM  the  appropriate  values  for  this  device.  The  eottfig  used 
in  the  examples  of  this  tutorial  contains  the  following  specifications: 

resistance  enh  static  10  10  103000 
resistance  enh  dynamic-high  10  10  10000 
resistance  enh  dynamic-low  10  10  10000 
resistance  p-chan  static  10  10  200000 
resistance  p-chan  dynamic-high  10  10  20000 
resistance  p-chan  dynamic-low  10  10  20000 


Appendix  4  -  The  *alla^  file  of  the  example  'shift*  (sectlen  3,23). 

The  alias  file  shift.al,  created  by  NETLIST  in  section  323.  has  only  one  line: 

=  in  outB 

This  tells  PRESIM  that  *in'  and  'out.lO*  have  been  connected  and  therefore  are  considered  as 
representing  the  the  same  node. 


*  Now  that  ihc  (cqncacc  of  leoglh  and  width  U  rrrened  ia  coanpariMW  to  iraatiftor  ipeciflcatioa  with 
(ptraoa  ...  ),  (etrana  ...  ),  etc. 
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Appcadis  5  •  Sommary  of  Typical  Coamaada  AsMdatcd  with  Slaalatloa  Toab 
netlist  basenamejiet  baseiuunejim 

purpose:  create  a  flattened  netlist  representation  from  an  hierarchical  representation, 
files: 

basenamejiet  (created  by  the  user) 

basename aim  (is  output  of  netlist.) 

presim  basenamejim  baseiuma  eoirfig 

purpose:  create  a  binary  circuit  representation  from  the  flat  circuit  representation, 
files: 


basename  (is  created  using  NETLIST,  input  to  PRESIM) 

basename  (is  output  of  PRESIM) 

config  (is  technology  file  provided  to  the  class) 


rnl  basename  J 

purpose:  run  the  simulation 
files: 

basenamei 


basename  Jog 

basename 
basename  «vl 


(created  by  the  user,  generally  arith  OEN.CONTROL, 
calls  out  the  other  files  for  inptvt  and  output: 
uwstdJ  (standard  library  routines) 
uarsim  J  (more  staadaru  library  routines)) 

(will  contain  all  the  stuff  displayed  on  the  terminal 
after  exiting  RNL  using  'exit*  or  ’(exit)*) 

(binary  network  representation  created  using  PRESIM) 
(contain  all  plotting  information  created  as  a  result 
of  the  chflag  command.) 


genjcomrol 

purpose:  set  up  a  control  file  for  a  circuit  for  the  first  time. 

files:  none  needed  for  input,  however  GEN_CONTROL  will  prompt  for  a  basename  and  an  out¬ 

put  file  bascname.1  will  be  created. 

genjime  basename  Jtim  basename  Jime 

purpose:  convert  a  simple  timing  file  in  a  RNL  compatible  format, 
files: 


basename  Jtim 


basename  .time 


(input  file  for  GEN-TIME;  specifies  input  waveforms 
in  terms  of  nodename,  period  and  intra-period  signal 
changes.) 

(output  file  which  is  Toaded”  into  the 
.’ontrol/basename  file.) 


m 
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pla2Hei  basename 

purpose:  generate  a  NETLIST  macro  for  the  pla  from  the  truth  table, 
files: 

basename Jt  (input  file  for  PLA2NET,  containing  the  truth  table.) 

basenamenet  (output  file  created  by  PLA2NET  containing  a  macro 
with  the  name  *basename’:  (macro  basename  out  in)) 


Appendia  <  •  Makefile  Conunaade. 

Step  1: 

change  the  variable  N  to  equal  the  basename  of  the  circuit  to  be  simulated  in  the  ’makefile’  file, 
unless  you  want  to  include  in  the  command  line  every  time  ’N=basename’. 

Step  2: 

run  the  appropriate  command: 

make  runs  all  programs  using  the  basenamejiet,  basenameatim  and  config  files  as  the  original 
source  files  only  when  necessary.  Where  files  do  not  exist,  the  programs  to  create  them 
will  be  run. 


make  e 

make  n 
make  p 
make  r 
make  1 
make  t 

make  filename 


remove  all  derived  files:  aim,  binary  file, 

.time,  iog,  al,  and  Jieh  files 
creates  the  aim  file  running  NETLIST 
creates  the  binary  network  file  running  PRESIM 
runs  RNL 

create  a  control  J  file  for  RNL  running  GEN_CONTROL 
create  a  timing  .time  file  by  running  GEN_TIME 
create  the  filename  requested  by  running  the 
appropriate  programs. 
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Appcodfai  7  •  A  Staple  Makefile 

#  makefile  for  RNL 

#  the  value  of  name  should  be  replaced  by  the  basename  of  the  circuit 

#  to  be  simulated  on  the  next  line:  e^.  N  «  shift  for  simulation 

#  of  the  shift  register. 

N  -  shift 

#  dependency  information 
$(N)Jog:  S(N)i  S(N)iimc  $(N) 

ml$(N)J 

$(N):  $(N)aim  config 

•  presim  $(N)aim  $(N)  config 

$(N)J: 

/usr/new/gen_controI 

$(N).timc:  $(N)xtim 

/usr/new/gen_time  $(N)atim  S(N).time 

$(N)aim:  $(N)jiet 

nctlist  $(N)jiet  $(N)jim 


#  datacalculation: 
a:  $(N)aim 
p:S(N) 
r:  $(N)Jog 
1:  $(N)J 
t:  $^).time 


c: 

rm  -f  core  $(N)Am  $(N)  $(N)iime  $(N)Jog  $(Na1)* 
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L  INTRODUCTION 

The  following  docament  is  intended  for  beginning  to  intermediate  users  of  the  following 
programs; 

•  NETLIST, 

*  PRESIM, 

fjj  •  RNL. 

Some  familarity  with  programming  and  the  use  of  a  computer  terminal  is  assumed. 

The  approach  used  here  is  to  provide  examples  that  have  been  developed  while  using  the 
programs  here  at  the  UW/NW  VLSI  Consortium.  They  are  by  no  means  exhaustive.  Much  of 
our  attraction  to  these  programs  is  their  flexibility.  This  is  particularly  true  in  the  RNL  inter* 
preter.  When  using  this  tutorial  copies  of  the  User's  Guides  (provided  separately)  should  be 
available. 

1.1.  Ground  Rules 

The  reader  is  encouraged  to  be  sitting  in  front  of  a  terminal  that  has  these  programs 
available.  Much  more  can  be  learned  by  making  the  unavoidable  mistakes  when  editing  files 
and  running  these  programs  than  by  just  reading.  Error  messages  are  at  times  cryptic  and  we 
make  no  effort  here  to  wade  through  them.  Readers  are  also  encouraged  to  experiment  and 
implement  their  own  idew.  One  very  instructive  method  is  to  take  these  examples  and  modify 
and/or  add  extra  capability.  Learn  by  doing. 

In  sections  where  readers  are  expected  to  be  editing;  the  text  to  be  entered  is  in  baM 
fact.  In  the  sections  on  the  interactive  use  of  RNL;  user  input  will  also  in  bold  face.  Program 
responses  are  in  normal  text.  We  recommend  that  an  editor  that  supports  Lisp  (e.g.  EMACS) 
be  used  if  at  all  possible. 

We  make  such  a  statement  as.  both  the  NETLIST  program  and  the  RNL  command  inter* 
preters  are  based  on  a  Lisp  syntax.  That  is  to  say  program  statements  (commands)  are  sur¬ 
rounded  with  parentheses  (  ).  A  general  template  for  a  command  is 

(coaunand_nama  arguments). 

It  should  be  assumed  that  all  commands  require  the  parentheses.  It  will  be  stated  explicitly  if 
they  are  not  required. 
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U.  Docnment  Strnctnn 

We  begin  by  discussing  some  of  the  basic  statements  used  in  writing  NETLIST  programs. 
This  will  be  followed  by  the  generation  of  the  so-called  .sim  file  of  transistors.  This  file  is  the 
basic  input  for  many  simulators.  Examples  of  using  the  program  PRESIM,  a  xim  file  prepro¬ 
cessor  that  generates  input  for  the  digital  simulator  RNL,  are  then  presented.  Simple  interac¬ 
tive  RNL  experiments  are  shown  and  techniques  for  running  RNL  in  batch  mode  are 
described.  We  end  with  some  of  the  basic  concepts  of  Liqi  and  a  tour  through  some  of  the 
Lisp  code  that  has  been  written  locally  to  facilatate  the  use  of  RNL. 

2.  BUILDING  A  NETWORK  DESCRIPTION  USING  NETLIST 

For  effective  design  it  is  important  to  establish  that  the  design  will  work  before  layout  is 
attempted.  The  program  NETLIST  allows  the  user  to  describe  the  circuit  with  a  symbolic 
language.  The  NETLIST  description  is  really  a  program  which  when  run  produces  the  list  of 
transistors  that  make  up  the  circuit.  The  following  is  a  simple  NETLIST  program  for  a  CMOS 
inverter.  These  commands  will  then  be  supplemented  with  others  that  will  allow  larger  cir¬ 
cuits  to  be  partitioned. 


gnd  gnd 

CMOS  inverter  NMOS  inverter 

2.1.  Simple  Commands 


;  All  text  following  a  semicolon  b  a  comment  and  b  Ignored  ;  (1) 

;  A  CMOS  Inverter  p  type  device  2X  width  ef  n  device  ;  (2) 

(noda  In  ont)  ;  (3) 

(ptrans  In  oat  vdd  S  S)  ;  (4) 

(etrana  In  gnd  ant  4  Q  ;  (5) 

(capacltanca  ont  0.03)  ;  (O 


1  As  indicated  by  thb  line  all  text  that  appears  after  a  senujolon  (;)  is  considered  a 

comment  and  b  ignored  by  NETLIST. 

3  Thb  line  declares  the  nodes  In  and  oar.  You  have  to  declare  each  node  that  you  use. 

Nodes  declared  with  the  node  command  will  be  referred  to  as  global  nodes.  Two  glo¬ 
bal  nodes  that  NETLIST  knows  about  without  your  explicitly  declaring  them  are 
vdd  and  gnd.  Some  programs  are  case  sensitive  and  it  is  recommended  you  use  them 
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as  they  are  shown  here.  This  redundant  piece  of  information  (after  all,  NETLIST 
can  see  that  you  are  using  a  symbol  as  a  node  name  when  it  builds  the  circuit) 
prevents  spelling  errors  from  causing  unnecessary  grief.  Declarations  are  not  as 
much  trouble  u  they  sound.  Later  a  scheme  will  be  presented  that  structures  the 
NETLIST  definition  so  that  most  nodes  will  be  local  to  some  module.  Local  nodes 
will  be  examined  shortly.  Using  this  technique  only  the  few  global  nodes  (usually 
clocks  and  i/o  signals)  have  to  be  declared. 

4  to  S  For  simple  circuits  these  are  the  two  commands  that  do  a  lions  share  of  the  circuit 
description.  They  identify  an  individual  transistor.  They  come  in  several  types  such 
as  etroHM  ->  n  type  *Hhan£ementll],  ptraiu  •>  p  type  etOumeement  and  dtram  ->  NMOS 
depletion  transistor.  There  are  others  and  the  interested  reader  is  encouraged  to 
examine  the  NETLIST  User’s  Guide  to  find  out  more.  In  most  CMOS  designs 
etrans  and  ptrans  should  suffice.  The  template  for  any  of  the  transistor  types  is 

(type  gate  source  drain  width  length). 

The  type  is  as  described  above.  The  gate,  source  and  drain  arguments  are  the  tenni' 
nals  of  the  transistor  being  declared.  In  line  4  the  p  type  transistor  is  gated  by  node 
in,  its  source  is  the  node  out  and  its  drain  is  vdd  (Hott  the  case  of  vdd  and  gnd  in 
lines  4  and  5).  Source  and  drain  in  NETLIST  is  used  solely  to  distinguish  between 
the  terminals  of  the  transistor  and  do  not  imply  anything  about  actual  operating 
potentials.  Width  and  length  ^ecify  the  size  of  the  transistor.  The  values  are  given 
in  a  length  parameter  lambda.  This  allows  for  some  technology  independence  in  the 
network  description.  This  unit  is  also  used  in  layout  programs.  Typical  values  for 
lambda  are  2-3  microns.  In  the  inverter  description  above  then,  the  n  type  transistor 
(line  S)  is  1/2  the  width  of  the  p  type. 

6  Finally  some  capacitance  is  modeled  on  the  node  out  with  the  use  of  the  capneltnncc 

command.  The  user  is  relieved  of  specifying  the  second  terminal  on  the  capacitor 
because  all  are  assumed  to  ground.  The  values  {0JD3)  are  in  units  of  picofarads. 

This  file  is  then  used  as  input  to  the  program  NETLIST.  The  actual  running  of  this 
example  is  deferred  momentarily  as  some  additional  NETLIST  commands  are  investigated. 

2J.  Additional  BollMn  Functions 

Up  to  now  we  have  used  the  transistor  comnunds  (etrans  and  ptrans)  and  the  capad> 
tones  command.  If  this  was  all  that  was  available  life  would  indeed  be  tough.  The  general 
requirements  for  additional  commands  are  function  type,  a  technology  and  device  sizes. 
Specification  of  the  technology  is  important  because  NMOS  uses  depletion  pullups  whereas 
CMOS  uses  p  type  enhancements.  Tliis  requires  a  slightly  different  handling  of  the  signals. 
In  NETLIST  such  commands  exist  and  we  will  go  through  some  now. 

A  CMOS  inverter  has  the  following  template 
(clavert  out  (In  width  length)) 

Clnvcrt  is  the  command  name  (tike  etrans  above)  and  is  followed  by  the  argument  declaring 
the  output  signal  (out).  The  next  element  of  the  command  may  look  a  bit  strange  but  in  con¬ 
veys  a  lot  of  information.  It  is  in  fact  a  data  structure  we  will  be  seeing  often,  the  details  of 
which  are  deferred  to  section  3  of  this  tutorial.  For  this  example,  it  is  declaring  the  input  sig* 
nal  to  be  in  and  it  defines  the  size  (width  and  length)  of  the  n  type  transistor  in  the  CMOS 
inverter.  This  nearly  satisfies  our  requirements  but  note  that  in  the  clnvert  command  (in 
width  length)  only  specified  the  size  of  the  n  type  transistor.  Where  is  the  p  device  size 
declared? 


(1)  HiMoricaly  NETLIST  wm  wrines  lo  dcKribe  NMOS  drcniis  where  there  it  juii  the  one  type  ot 
cahaaceaieiit  trtatitcor. 
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This  is  a  historical  artifact  of  the  NETLIST  program.  In  NMOS  the  pullup  is  a  depletion 
mode  transistor  which  has  its  gate  tied  to  the  source.  In  the  case  of  an  NMC^  inverter  then 
the  gate  of  the  depletion  device  is  in  fact  the  output.  (This  is  also  true  of  nand  and  nor 
gates.)  For  the  q)ecial  case  of  NMOS  design,  we  have  a  command  that  looks  like 

(Invert  (Mt  width  length)  (In  width  length)). 

As  you  can  see  the  depletion  pullup’s  size  is  declared  on  the  output  node.  Similarly  NMOS 
nand  and  nor  gates  have  the  same  form[2].  In  this  context  then  the  structure 

(node_name  width  length) 

specifies  the  size  of  the  transistor  gated  the  node  node_name. 

In  CMOS  the  input  gates  both  the  p  and  n  transistors.  Moreover,  nand  and  nor  gates 
have  equal  numbers  of  pullup  (p  type)  and  pulldown  (n  type)  transistors,  the  sizes  of  which 
could  vary  independently.  Clearly  some  other  solution  must  present  itself. 

The  command  mtto  is  the  current  solution  to  this  dilemma.  Its  template  is 

(ratio  value) 

Ratio  is  the  command  name  and  value  is  a  constant  that  is  used  to  set  the  width  of  the  p  dev¬ 
ice.  The  p  device’s  width  is  the  product  of  value  times  the  width  of  the  n  device  ($p  sub  width 
*=*  value  n  sub  widthS).  The  default  for  value  is  2X).  The  lengths  of  the  two  transistors 
are  assumed  equal.  This  doesn’t  not  allow  for  complete  independence  of  device  size  but  has 
worked  well  in  practice. 

Returning  to  our  need  for  a  CMOS  inverter  command,  we  are  left  with  the  following 

(nods  In  ooC)  ;  (1) 

(ratto  2.0)  ;  (2) 

(clnvert  out  (In  4  S))  ;  (3) 

Of  course  we  still  need  the  node  command  as  before.  The  last  two  commands  arc  equivalent 
to  the  transistor  commands  discussed  earlier. 


(ptrans  in  out  vdd  8  8) 

(etrans  in  gnd  out  4  8) 

Its  hard  to  see  the  gain  with  this  example  but  if  we  consider  the  two  possiblities  for 
CMOS  nand  and  nor  gates  the  advantages  start  to  present  themselves.  Within  this  scheme  one 
could  gueu  the  commands  for  a  3  input  nand  to  be, 

(node  eat  Ini  In2  InS)  ;  (1) 

(ratio  2.0)  ;  (2) 

(cnand  oat  Ini  Ia2  laS)  ;  (3) 

Again  input  and  output  nodes  have  to  be  declared  with  aoda.  By  dropping  the  width  and 
length  arguments  for  the  inputs  we  have  a«aumed  default  sizes  for  the  enhancement  transistors 
(2  lambda  x  2  lambda).  The  ratio  command  sets  the  p  devices  to  be  two  times  the  width  of 
their  corresponding  n  type  just  as  before.  The  equivalent  transistor  description  in  this  case  is 


{2]  For  esaoiple  a  ooaqricw  (pacifleadoo  of  2  iop«i  oaod  aod  oor  plea, 
(oaad  (out  width  leasih)  (ial  widthl  leogihl)  (iii2  wid(h2  ieosihZ)) 
(oor  (out  width  leitfih)  (tot  widthl  leagthi)  (ia2  width2  Ingih2)) 
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getting  quite  large 


(node  oat  Ini  Ini  In3  1 2)  ;  (1) 

(etnno  Ini  1  out)  ;  (2) 

(etnna  In2  2  1)  ;  (3) 

(ctruu  In3  gnd  2)  ;  (4) 

(ptrano  Ini  oat  vdd  4  2)  ;  (5) 

(ptrono  in2  oat  vdd  4  2)  ;  (6) 

(ptrano  InS  oat  vdd  4  2)  ;  (7) 


1  to  3  If  we  explicitly  describe  the  3  input  nand  we  have  to  declare  2  additional  nodes. 
Nodes  I  and  2  are  not  particularly  interesting  as  their  only  function  is  describing  the 
connectivity  to  ground  (grid)  from  the  output  node  out  (lines  2  and  3).  Note  when 
we  used  the  built-in  function  they  needn’t  be  declared.  NETLIST  recognized  the 
need  for  these  'local*  nodes  and  generated  their  names  automatically.  NETLIST 
always  uses  numeric  node  names  for  local  nodes  and  the  user  is  strongly  advised  to 
avoid  their  use  in  node  delcaration  conunands.  In  the  next  section  will  we  see  how 
these  automatic  nodes  can  be  exploited  even  further. 

S  to  7  The  dual  of  the  pulldown  chain  doesn’t  require  any  additional  nodes  but  the  2  to  1 
ratio  in  transistor  width  must  be  explicitly  declared. 

The  same  situation  is  encountered  with  CMOS  nor  gates[3].  Additional  built-in  func¬ 
tions  of  this  nature  are  provided  in  NETLIST.  The  NETLIST  User’s  Guide  contains  a  brief 
description  of  each  and  in  many  cases  contrasts  the  built-in  function  to  its  transistor 
equivdent. 


2.3.  User  Defined  Fanetloas  (Macros) 

As  shown  in  the  previous  section  one  of  the  main  advantages  of  the  built-in  functions 
was  the  recognition  and  generation  of  the  local  nodes.  The  task  of  providing  built-in  func¬ 
tions  for  all  the  possible  cases  where  they  appear  would  be  impossible  but  NETLIST  provides 
an  alternative.  If  user  defined  functions  can  be  used  as  if  they  were  built-in  then  specialized 
modules  can  be  created  as  their  need  arises.  An  example  of  this  would  be  if  the  device  sizing 
of  the  gate  functions  was  inappropriate  for  a  design,  a  new  function  could  be  designed  that  fit 
the  requirements. 

User  defined  functions  are  built  in  the  form  of  macros.  One  way  to  think  about  a  macro 
is  a  replacement  for  a  related  set  of  commands.  Macros  can  have  calling  arguments  (much 
like  FORTRAN  subroutines)  and  their  own  nocar  nodes.  Several  examples  of  user  declared 
macros  will  be  presented  in  this  section. 

From  a  design  point  of  view  the  macro  of  a  SR  latch  shown  below  is  not  recommended. 
The  choice  was  made  to  include  an  example  where  the  circuitry  needs  little  explination  so  that 
the  important  features  of  the  macro  are  evident.  As  has  been  the  pattern  important  features 
are  descibed  on  a  line  by  line  basis. 


:  CMOS  SRIatefe  macra  ;  (i) 

;  Inverters  are  ratloed  @  2  J  •  (2) 

;  Nud  gates  are  ratloed  0  1.0  >  (3) 

(macro  SRIatch  (m_S  m_R  m_Q  m_Q>)  ;  (4) 

(local  hi  h2)  "  ;  (5) 


(3]  A  3  iapoi  CMOS  aor  gate  with  default  dze  a  Iraoditota  to 
(coor  out  iol  ini  ia3) 
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SR  latch 


(ratio  2.0)  ;  (() 

(clovtft  hi  in_S)  ;  (7) 

(clavcrt  hi  a  R)  ;  (8) 

(ratio  1.0)  ■  t  (») 

(cnand  a_Q  hi  in_Q*)  ;  (10) 

(cnand  m_Q>  hi  a_Q)  ;  (11) 

(capacitaacc  hi  0.0^  ;  (12) 

(capacltaoco  hi  0.05)  ;  (13) 

;(i4) 


to  3  Comments  just  as  before  a  begun  with  and  are  ignored  by  NETLIST.  They  are 
useful  especially  as  time  goes  by  and  you  wonder  what  something  really  does. 

This  is  the  begining  of  the  macro  command.  Its  template  is 
(auero  moao  (parasaatoro) 

A  macro  is  called  with 

(name  (calllBg_argaacnts)) 

Macros  all  begin  with  the  left  parenthesis  and  the  word  macro  ’(macro*  followed  by 
the  macro’s  name  (SRIaieh).  Following  the  name  is  the  list  of  formal  parameters. 
The  number  and  type  of  calUngjargiaaeias  must  match  the  formal  parameters.  As 
mentioned  earlier  this  similar  to  the  parameters  in  a  FORTRAN  subroutine.  For 
example  if  a  parameter  is  used  u  a  n<^e  name  in  the  nucro’s  definition  then  when 
the  macro  is  called  the  corresponding  calling  argument  must  be  a  declared  node 
name.  The  only  way  encountered  so  far  to  declare  a  node  name  is  with  the  use  of 
nods.  Line  S  introduces  another  way  to  declare  a  legal  node  name. 

Following  the  declaration  of  the  macros  name  and  parameter  list,  any  local  nodes 
that  are  needed  are  q>ecified  by  the  local  command.  Its  form  is  exactly  like  the  nods 
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command.  This  is  useful  because  it  helps  in  remembering  what  local  does.  It  gives 
us  a  means  of  declaring  the  local  names  to  a  function  and  thus  eliminates  the  need 
to  specify  them  along  with  the  important  global  signals  (clocks,  i/o,  control)  within 
the  eirenit.  Every  time  the  macro  is  called  new  nodes  names  are  generated  for  these 
local  nodes.  Again  we  stress  the  fact  that  NETLIST  uses  numeric  node  names  for 
these  and  one  should  avoid  the  use  numeric  node  names  in  any  other  context. 

6  to  13  This  is  the  body  of  the  macro.  Any  of  the  built-in  functions  can  be  used  as  a  state¬ 
ment  in  the  body.  In  addition  any  previously  defined  user  macros  can  be  statements 
in  the  body  of  the  macro  (shown  in  next  example).  Lines  7  and  8  also  reflect  that 
within  the  macro  local  nodes  can  be  used  just  like  the  ^obal  nodes  we  have  seen 
earlier.  Lines  6  and  9  show  the  use  of  the  ratio  command.  The  scale  values  are  set 
to  2j0  and  li)  respectively.  Upon  exit  from  the  macro  the  scaling  value  remains 
equal  to  IJO.  This  can  cause  confusion  and  it  is  recommended  that  the  ratio  com¬ 
mand  be  used  frequently  to  ensure  you  are  using  the  scale  value  you  intended. 

14  This  right  parenthesis  *1  completes  the  macro.  Careful  inq>ection  will  show  that  this 
matches  the  left  parenthesis  used  in  line  4.  the  begining  of  the  macro  declaration. 

As  a  practical  matter  how  and  where  does  the  use  of  the  macro  enter  into  the  NETLIST 
program?  For  one  thing  the  names  in  the  parameter  list  must  not  conflict  with  the  names  of 
the  global  nodes.  The  folloaring  NETLIST  program  demonstrates  the  nesting  of  macros  and 
hopefully  provides  a  clear  introduction  to  their  use.  We  will  also  take  this  opportunity  to 
introduce  a  command  that  alloars  repetition  of  a  group  of  commands. 


6  Transistor  Memory 


;  macro  for  a  <  transistor  memory  cell,  traailator  dUng  from  ;  (1) 

;  'Analyds  and  DcsIgB  of  Digital  Integrated  CIrentts  *  ;  (2) 

;  David  A.  Bodges  and  Horace  G.  Jackson.  ;  (3) 

(macro  mem  cell  (m  ed  m  ed-  m  d  m  d-)  ;  (4) 

(local  hi  lii)  “  ■  "  "  ;  (5) 

(ratio  fl.125)  ;  (() 

(cinvert  hi  (hi  1<  2))  ;  (?) 
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(clBTCit  hi  (hi  16  2))  :  (6) 

(etnas  ■  ed  ai_d  hi  4  2)  ;  (9) 

(etnas  si.ed-  njd-  h2  4  2)  :  (10) 

)  ;  (11) 

;  sod  ■sa.csU  ;  (12) 

;(13) 

;  Bucn  for  geasntloa  of  aoiward  s  ■axbtt  asoMcy  ;  (14) 

;  nqalns  onen  aMa_ccll  ;  (15) 

;  bit  sod  word  iodn  beglas  at  t  ;  (16) 

(oMcn  aMa_tsa  (■osword  ■■shit  ■_sd  ai_cd-  n_d  si_d*)  ;  (17) 

(npeot  r  0  oiasward  ;  (It) 

(repeat  e  0  snzbit  ;  (19) 

(■sfli.cell  ai_ed^  ai_ed«^  ■.Ox  si_d*x)  ;  (20) 

(capodtaoce  ajdx  0^  ;  (21) 

(capacttaoce  ajd'X  0  J)  ;  (22) 

)  :(23) 

)  ;  (24) 

)  :(25) 

;  eod  ■coi.fea  ;  (26) 

;(27) 

;  Bepla  oiala  body  ef  oieaiory  leacratloa  ;  (2t) 

(aode  ed  d  ed*  d*)  ;  (29) 

(meajiea  2  2  ed  ed*  d  d-)  ;  (30) 

:  eod  oiala  ;  (31) 


1  to  11  The  first  macro  declared  is  for  a  6  transistor  memory  cell.  The  flip*fiop  is  con* 
stnicted  from  two  cross^oupled  inverters  (lines  7  and  8).  Note  the  use  of  local  vari* 
ables  within  the  fiip*fiop.  The  enable  lines  contrtd  the  reading  and  writing  of  bits  or 
words  into  the  fiip>fiop.  In  declaring  the  parameters  to  a  macro  one  must  use  some 
care.  Note  in  line  4  the  prefix  m_.  This  is  used  as  a  mnemornic  for  formal  macro 
parameters  and  limits  the  possiblity  of  use  the  same  name  as  global  node  name. 
Another  point  that  should  be  made  in  this  example  is  the  use  of  a  faction  in  the 
ntlo  command  on  line  6.  This  is  perfectly  reasonable  when  the  drive  must  be  very 
weak  as  is  the  case  in  such  a  memory  cell.  As  noted  in  the  comments  a  discussion  of 
the  transistor  sizing  can  be  found  in  'Analysis  and  Design...*  The  simulation  of  the 
6  transistor  memory  cell  is  beyond  the  scope  of  this  tutorial  but  is  covered  in  section 
4  of  the  RNL  User’s  Guide.  Finally,  note  the  general  formatting  of  the  macro.  The 
closing  right  parenthesis  (line  11)  is  aligned  with  its  correqionding  left  parenthesis. 
When  writing  macros  some  scheme  like  this  should  be  employed.  Some  editors 
(EMACS)  provide  commands  that  will  identify  corresponding  pairs  of  parentheses. 
As  macro  size  increases  use  of  an  editor  with  this  capability  is  strongly  recom* 
mended. 

14  to  25  This  macro  follows  the  same  general  scheme  that  has  been  outlined  before.  Import 
tant  thinp  to  note  here  is  the  use  of  a  new  command  and  the  nesting  of  one  macro 
in  another.  When  nesting  one  macro  it  is  important  to  remember  that  a  macro  must 
be  declared  before  it  is  executed.  Line  18  provides  a  very  useful  capability  when 
describing  circuits.  Repeat  is  much  like  the  FORTRAN  DO  loop.  It  hu  the  tern* 
plate 


(repeat  index  initial  final 
statements  within  repeat  block 

) 


•  8  • 


UW/NW  VLSI  Coniortium 


NETLIST/PRESIM/RNL  -  A  Tutorial 


Ab  indci  (lioc  IS  r  and  liae  19  e)  ia  declared  aod  followed  by  its  initial  and  final 
valoca  (C4. 0  and  sMzwerd  oa  line  18).  As  stated  ia  the  introduction,  this  command 
ia  coataiaad  withia  a  set  of  paeeathaaaa  (note:  formatting  can  be  very  important  dur> 
iag  the  debaggiag  pcoeam).  Froai  the  eiaaiple  it  is  obvious  that  repeat  loops  can  be 
nested.  Note  how  we  ns«^  the  repeat  loop  indiciea  in  constructing  new  node  names 
(line  20).  This  is  a  very  powerful  feature  ia  NETLIST  programs.  This  ability  gives 
us  a  third  hind  of  node  aaaM.  global  and  local  detailed  earlier  and  structured.  A 
structured  name  has  two  or  more  cooipooeats  separated  by  periods.  The  first  com* 
poaeat  must  be  a  deelared  node  asaw.  As  we  have  seen  node  names  can  be 
declared  with  a  taenl  or  a  aade  cowimaad.  Another  way  is  as  it  used  here  where  the 
declared  naaw  comes  froai  oae  of  the  panaictets  to  the  macro  (Recall  that  node 
names  used  ia  ealliag  a  asacro  mtut  be  declared  names.);  the  remaining  components 
can  be  other  naases  or  eapreasiaaa.  Here  we  have  used  the  indicies  from  the  repeat 
commands.  You  only  have  to  declare  non-numeric  components  of  structured  names 
-  for  example,  only  'ed*  must  be  declared,  not  *ed.r,  *ed2*,  etc.  (  see  line  29).  Full 
details  can  be  found  ia  the  NETLIST  UserY  Guide. 

to  30  Finally  we  see  that  the  main  body  of  NETLIST  program  hu  been  reduced  to  2 
statements.  Declaring  the  global  node  names  and  calling  memory  generator  macro 
msai_fsa.  Again  note  how  a  user  defined  macro  is  used  just  like  the  built-in  func¬ 
tions  described  earlier. 

2J.1.  f  ending  Mneres 

Up  to  now  we  have  included  all  of  the  the  macros  that  were  required  for  the  circuit 
descriptions  in  one  file.  However  to  use  the  mem.ceil  and  meai_gcB  macros  shown  above  it 
would  be  useful  to  be  able  to  incorporate  them  into  another  design  file  without  typing  them  in 
in  their  entirety.  This  can  be  done  with  the  use  of  the  lead  command.  Its  template  is 

(lead  'fUename') 

The  actual  filename  is  up  to  you  but  it  must  be  surrounded  by  double  quotes  The  practical 
effect  is  that  any  legal  NETLIST  commands  and  any  the  macros  contained  in  the  file  are  made 
available  to  the  remainder  of  the  program  just  as  if  they  were  typed  in.  An  important 
requirement  a  macro  must  be  loaded  before  it  is  executed.  This  is  really  the  same  require¬ 
ment  mentioned  earlier,  that  a  macro  must  be  declared  before  it  is  used. 

By  putting  the  macros  aicm_ccll  and  mcm _gen  in  a  separate  file  aod  with  the  load  com¬ 
mand,  we  could  rewrite  the  program  for  generating  the  2x2  memory. 

(load  'mem _prlmltlvc^)  ;  (i) 

(aodo  cd  d  cd-  d-)  ;  (2) 

(mcni_gm  2  2  od  od-  d  d-)  ;  (3) 

Where  the  file  mem ^primitives  contains  the  NETLIST  code  for  aicm_cell  and  mcm_gca. 

2.4.  Summary 

This  concludes  the  section  on  building  circuit  descriptions  using  NETLIST.  We  have 
discussed  the  following  points 

*  Transistor  descriptions  (04.  etrans,  ptrans), 

*  Node  name  types  (e.g.  global,  local  and  structured), 

*  Built-in  functions  (04.  cinvert,  cnand,  cnor), 

*  User  defined  functions  (i^e.  macros), 

*  Repeating  blocks  of  NETLIST  statements  (i.e.  repeat). 
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*  Loading  previously  defined  macroa  (i«.  load). 

In  following  sections  details  of  generating  transistor  files  for  simulation  will  be  investi¬ 
gated.  A  flexible  command  language  for  simulation  and  an  elaborate  example  of  simulating  a 
large  design  will  be  described. 

There  are  many  more  functions  that  can  be  used  in  writing  NETLIST  programs.  More¬ 
over,  arithmetic  functions  and  common  Lisp  functions  are  available.  These  features  are 
beyond  the  scope  of  this  tutorial  but  users  are  encouraged  to  refer  often  to  the  reference 
manuals. 


3.  GENERATION  OF  PRESIM  AND  RNL  INPUT  PILES 

The  below  is  a  session  of  running  the  netilal  and  prsria  commands  in  the  C  shell  of 
UNIX(4).  Following  the  session,  comments  are  indexed  by  tine  number. 


%  nsUlst  lavsrtsr.asl 

I  units:  230  tech:  T!7  format:  MIT 
p  in  out  vdd  8j0  8j0  0  0  r  64j0 
e  in  gnd  out  8j0  4.00  0  0  r  32.0 
c  out  3JOOOOOOe4)l 
%  netllat  InvcrtsrMt  -tiascmss 
I  units:  250  tech:  isocmos  format:  MIT 
p  in  out  vdd  8j0  8j0  0  0  r  64j0 
e  in  gnd  out  8j0  4.00  00 1  32.0 
c  out  3i)00000e-01 

%  nstllst  lnvartar.asl  -tisocoMS  -alfit 

I  units:  200  tech:  isocmos  format:  MIT 
p  in  out  vdd  8j0  8i)  0  0  r  64j0 
e  in  gnd  out  8J0  4.00  0  0  r  32.0 
c  out  3IKXXX)0e-01 

%  nsUlsl  Inverter  .net  Inverter  nim  -tiaeci 
%  preslm  Inverter  Jlm  Inverter 

Version  42 

8  nodes:  transistors:  enh^l  intrinsic=0  p-chan=l  dep- 
Total  transistors  eliminated  >  2 
%  predm  Inverter  jlm  Inverter  conflg 
8  nodes;  transistors:  enh»l  intrinsic^  p-chan^l  dep> 
Total  transistors  eliminated  =  2 
% 


(1) 

(2) 

(3) 

(♦) 

(5) 

(6) 

(7) 

(8) 

(9) 

(10) 
(11) 
(12) 

(13) 

(14) 

(15) 

(16) 

(17) 

(18) 


=0  low-power=>0  pullup^  resistor*0  ;  (19) 
:(20) 

;(2i) 

'0  low-power  =4)  pullup=0  resistor  =0  ;  (22) 
;(23) 

:(24) 


1  This  command  runs  the  program  NETLIST.  This  is  the  simplest  form  of  the  eom- 
mand.  That  is,  only  an  input  file  inverter Jiet  is  specified.  The  contents  of 
invertermet  is  the  CMOS  inverter  described  in  the  previous  section.  Output  from 
netllat  will  be  referred  to  as  aim  file.  With  this  usage  of  the  command  the  aim  file 
(lines  2  to  S)  is  sent  to  standard  output  which  in  this  case  is  the  terminal. 

2  A  line  that  begins  with  a  vertical  bar  (I)  is  generally  a  comment  in  the  aim  file  and  is 
ignored.  The  only  exception  to  this  is  when  a  aim  comment  begins  with  a  line  of  the 
form  in  2.  This  line  is  required  by  programs  in  the  Berkeley  and  UW  tool  sets.  It 
contains  a  conversion  number  (units:)  and  a  specification  of  the  technology  type 
(tech:)  and  finally  the  format:  of  the  aim  file  itself.  Two  formats  are  used  within  the 
UW/NW  tools,  the  MIT  format  here  and  the  UCB  format  produced  by  the  layout 
extractor  mextra. 


[4]  UNIX  U  ■  trademuk  of  Bdl  Laboratoricf  and  tba  C  dtelt  ia  a  conoiaad  tbell  leaarally  aaed  with  the 
4.1BSO  UNIX. 
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3  to  S  Lines  3  and  S  represent  the  transistors  in  the  inverter  circuit.  The  MTT  template  for 
*hese  'tranaiat<n  records*  is  the  foUowiog; 

type  gate  source  drain  length  width  zpos  ypos  shape  area. 

Type  identifies  transistor  records  as  n  type  enhancement  (e)[S],  p  type  enhancement 
(p)  or  when  designing  in  NMOS  depletion  (d).  Gate,  source  and  drain  are  of  course 
the  terminals  of  the  transistor.  Xpos  and  ypos  would  provide  the  location  of  the 
transistor  if  the  jim  file  was  extracted  from  a  layout.  In  this  case  when  only  the 
connectivity  is  being  deelared  these  values  are  set  to  0.  Length  and  width  represents 
the  size  of  the  transistor.  When  a  aim  file  is  obtained  from  a  layout  and  if  a  transis¬ 
tor  is  oddly  shaped,  they  ate  approximate  values.  If  an  actual  transistor  is  something 
other  than  rectangular,  it  is  indicated  with  the  shape  field.  A  rectangular  shape  ('t^ 
is  assumed  when  the  aim  file  is  generated  by  NETLIST.  Area  is  the  total  gate 
area.  Line  29  reflecta  load  c^acitance  declared  in  the  NETLIST  input  file  (in 
picofarads). 

6  In  this  command  the  additional  input  parameter  has  been  declared.  Note  there  is 

no  space  between  the  option  flag  and  the  technology  name.  As  can  be  seen  the  out* 
put  Oines  7  to  10)  is  subatainally  the  same  except  with  the  technology  now  being 
declared  as  isoemos. 

11  This  time  we  have  added  another  option  which  sets  the  centimicron  value  of  lambda 
to  200  (in.  lambda  2j0  centimicrons).  Again  there  is  no  space  between  the  option 
flag  (hi)  and  the  value.  This  option  is  not  refected  in  the  transistor  sizes  as  both 
length  and  width  are  the  same  as  the  tines  7  through  10.  Rather  the  units:  parame¬ 
ter  is  now  200  rather  than  250. 

16  This  is  the  usual  form  of  the  nstUat  command.  Here  we  have  specified  an  input  file 
invenerjiet,  an  output  file  Inverter jim  and  a  technology  isoemet.  When  an  output 
file  is  desired  it  must  appear  as  the  second  argument  in  the  command. 

17  The  command  prcslm  prepares  a  binary  file  for  input  to  RNL.  Presim  reidaces  the 
transistors  in  the  aim  file  with  an  equivalent  sized  resiston.  The  equivalent  tesistors 
are  used  with  any  capacitance  on  a  node  to  compute  an  estimate  of  its  transition 
delay  time.  The  command  must  contain  an  input  file  (inverter  Jim)  and  an  output 
file  (inverter).  The  defaults  for  this  replacement  are  the  source  of  no  end  of  confu¬ 
sion  for  new  users.  The  rule  of  thumb  for  the  ratio  of  the  conductivity  of  n  type 
enhancements  to  p  type  enhancements  is  2J0  to  2S  Unfortunately,  presim  default 
assumes  that  all  transistors  have  identical  conductivity.  To  its  credit  presim  does 
allow  the  user  to  parameterize  the  re^anee  and  capacitance  values  by  the  use  of 
the  so-called  config  file  (see  PRESIM  User’s  Guide  and  section  3  of  the  RNL  User's 
Guide).  The  use  of  this  file  is  shown  on  line  21  of  this  example. 

19  to  20  Rresim  provides  some  additional  output  to  the  terminal.  Line  19  contains  informa¬ 
tion  about  the  number  of  unique  nt^es  encountered  and  a  count,  by  type,  of  the 
transistors  in  the  circuit.  The  node  count  of  8  is  of  no  concern.  The  expected  node 
count  of  4  (in,  out,  vdd  and  gnd)  has  4  nodes  added  to  it  that  presim  uses  internally. 
Presim  includes  a  network  reduction  scheme  that  improves  execution  speed  during 
simulation.  In  effect  it  attempts  to  find  a  sum-of-products  representation  for  as 
many  of  the  nodes  as  possible.  This  hu  the  practical  effect  of  reducing  the  number 
of  nodes  (e.g.  local  nodes  internal  to  the  gate  primitives)  and  transistors,  line  20 
reports  the  number  of  transistors  involved  in  sum-of-products  representations. 

21  to  24  As  mentioned  earlier  the  configuration  file  is  required  when  the  resistor  replacement 
operation  needs  parameterization.  As  can  be  seen  the  practical  effect  when  issuing 
the  presim  command  is  to  add  an  additional  option  (config).  This  option  is  the 

(S)  The  oolaiioa  for  lb*  irudiior  types  reflKti  the  hinory  of  this  dnittlator.  It  was  origiiMUy  tfeMgaed 

with  NMOS  circuits  io  iiiio<i  where  there  is  but  one  type  of  eflhaaceuient  transistor. 
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name  of  the  configuration  file  you  wish  PRESIM  to  use.  A  extremely  simple 
configuration  file  that  sets  the  conductivity  ratio  of  n  to  p  type  transistors  to  2/1  is 
shown  below; 


rcsIataMt  enh  static  M  Ifi  lOOOt 
rcsistaacc  aah  dyaaaUC'law  M 1#  IMOt 
rcdataace  aah  dyBMk-Ugh  M  M  lOOM 


rcdstaaea  p^haa  atatk  Id  Id  Idddd 
rcalstaace  p^haa  dyaaask-law  Id  Id  Idddd 
radstaace  p<haa  dyaamk^blgh  Id  Id  2dddd 

The  template  is 

resistance  t*type  r-type  I  w  value 

Resistance  is  a  keyword  for  preaim.  T-type  identifies  the  traasiftor  type  and  r-type 
the  resistance  type.  The  three  values  shown  are  discussed  in  section  2  of  the  RNL 
User’s  Guide.  L  and  w  are  the  length  and  width  of  the  transistor  that  has  a  resw- 
tance  given  by  the  last  parameter  (value). 

3.1.  Rcvlsw 

We  have  run  two  very  important  programs  for  the  simulation  of  digital  circuits  using 
RNL.  NctUat  is  a  program  that  generates  the  transistor  representation  for  the  circuit.  Fre¬ 
quently  used  options  were  outlined.  Many  more  exist  and  interested  readers  are  encouraged 
to  read  the  NETLIST  User’s  Guide. 

Prcala  is  a  preprocessor  for  the  digital  circuit  simulator  RNL.  It  performs  a  transistor 
resistor  replacement  that  is  used  by  RNL  to  g^e  estimates  of  the  signal  delay  times.  Its  major 
pitfall  is  the  default  value  for  the  resistance  of  p  type  transistors.  A  simple  'workaround*  was 
presented  by  the  use  of  the  configuration  file.  Again  much  more  can  be  done  with  the 
configuration  file  and  this  information  can  be  found  in  the  PRESIM  and  RNL  User’s  Guides. 

4.  INTERACTIVE  SESSION  WITH  RNL 

The  following  is  an  interactive  session  with  RNL.  It  includes  loading  additional  Li^ 
interface  functions,  formatting  the  results  of  a  simulation  step  and  running  the  inverter  test 
case. 


%  ml  ;  (0) 

(load  'owstd4')  ;  (1) 

done  ; (2) 

;(3) 

(lead  *nwslmJ*)  ;  (4) 

Loading  uwsimJ  ;  (S) 

Done  loading  uwsimJ  ;  (6) 

done  ; (7) 

;(8) 

(read-network  'Invortar^  ;  (9) 

;  8  nodes,  transistors:  enh^  intrinsic«0  p-chan»0  dep*0  Iow-power-0  pulIup-0  resistor*0  ; 
done  ;  (11) 

;(12) 

(dtf-report  ’('Current  state:*  newline  la  out))  ;  (13) 

('Current  stater*  '  ;  (14) 

'  in  out)  ;  (15) 

;(16) 
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(cliflag  *(ta  oat))  ;  (17) 

(in  out)  ;  (18) 

;(19) 

1  la  ;  (20) 

done  :  (21) 

•  ;  (22) 

;(23) 

Step  begins  @  0  ns.  ;  (24) 

tn-0  @0  ;  (2S) 

out^l  @  OjS  i  (2b) 

Current  state:  ;  (27) 

Current  time*  100  ;  (28) 

;(29) 

in“0out*l  ;(30) 

done  :  (31) 

h  la  ;  (32) 

done  ;  (33) 

i  ;(34) 

;(3S) 

Step  begins  @  100  ns.  ;  (36) 

in-1  ®  0  ;  (37) 

out*0  ®  0j6  ;  (38) 

Current  state:  ;  (39) 

Current  time-  200  ;  (40) 

;(«) 

in*lout=0  ;(42) 

done  :  (43) 

(•»lt)  ;  (44) 

%  ;(45) 


0  From  the  C  shell  (note  the  '%  *  prompt)  issue  the  command  ral. 

1  to  7  From  within  the  RNL  command  interpreter  issue  the  commands  (load  'owatdJ*)  and 

(load  'owstdJ*).  The  two  files  uwstdJ  and  uwsimJ  provide  users  of  RNL  with  a  sim¬ 
ple  command  interface.  In  general  these  files  will  be  loaded  every  time  RNL  is 
used.  The  interpreter  when  finished  with  a  load  command  returns  'done'  (lines  2 
and  7  ).  Many  of  the  commands  return  this. 

9  The  read-actwork  command  is  issued  next.  This  reads  the  file  prepared  by  prcsim 

and  in  effect  builds  the  network  that  is  to  be  simulated.  Recall  when  prcsha  was 
run  it  provided  a  summary  of  the  network.  Similarly  read-network  returns  a  sum¬ 
mary  (line  10)  however,  the  node  and  transistor  count  now  reflects  only  those 
renmining  after  presim.  For  this  example  there  were  no  internal  nodes  and  the  node 
count  is  unchanged.  Again  in  line  11  'done'  is  returned  by  the  command  inter¬ 
preter. 

13  Dcf-repoft  is  a  function  provided  in  the  uwsimJ  package  that  allows  users  to  format 
a  report  that  is  printed  at  the  end  of  each  simulation  step.  In  setting  a  format  up  it 
is  important  that  it  begin  with  ’(  and  end  with  ).  In  this  case  we  have  a  simple  for^ 
mat  that  prints  out  the  string  'Current  State.^.  A  string  of  some  kind  is  required 
the  shortest  one  being  the  null  string  ".  Following  the  string  is  a  newline  (newlines 
are  interpreted  as  the  sequence  carriage  return,  linefeed).  Then  we  request  that  the 
states  of  the  nodes  with  the  names  in  and  out  be  printed.  Def-report  does  not  return 
'done'  like  before  but  some  rather  odd  text  (line  IS)  that  for  the  purposes  of  the 
tutorial  can  be  ignored. 
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17  Chflag  it  another  function  provided  in  the  uwsimJ  package  that  informs  the  simula¬ 

tor  which  nodes  should  have  their  transition  times  reported.  This  is  dons  by  declar¬ 
ing  a  quoted  list  of  symbols  that  have  the  same  print  names  as  the  node  you  are 
interested  in  (ej.  im  and  ou).  Quoted  lists  in  Lisp  begin  with  ’(  and  end  with  ). 
Alert  readers  will  note  that  the  def-report  in  line  13  is  also  a  quoted  list.  The  list  is 
returned  (printed)  by  chflag  when  it  is  finished. 

The  arguments  to  the  RNL  command  intetpreter  formally  are  known  as  Lisp  symbols. 
In  most  cases,  these  symbols  will  have  the  same  print  names  as  nodes  in  the  circuit  (i.e.  you 
type  the  same  string).  We  have  already  seen  examples  of  this  in  the  setup  phase  detailed 
at^e.  In  the  following  we  will  refer  to  the  arguments  of  many  of  the  commands  as  nodes. 
This  is  only  to  avoid  clutter,  they  are  in  fact  Lisp  symbols.  A  discussion  of  the  evaluation  of 
Lisp  symbols  etc.  is  deferred  to  section  S  of  this  tutorial.  In  areas  of  potential  confusion  we 
will  refer  to  them  as  Liq>  symbols.  In  this  same  vein  all  the  commands  described  for  the  rest 
of  this  example  are  provided  in  the  uwsImJ  package.  This  should  be  assumed  unless  it  is 
noted  otherwise. 

We  are  now  in  a  position  to  do  some  simulation  of  the  inverter.  The  commands  that  are 
presented  here  are  simple.  With  some  experience  with  the  Lisp  interpretor  much  more  ela¬ 
borate  commands  can  be  written.  That  is  not  the  subject  here  however  and  is  deferred. 

20  I  (h  and  n  described  later)  is  a  command  that  sett  ail  of  the  nodes  listed  (e.g.  in)  to  a 
logic  low.  Note  this  and  related  commands  do  not  require  surrounding  ()  when  run 
interaetivly.  This  value  will  not  change  under  any  simulation  conditions.  Using  this 
and  related  logic  commands  hat  the  effect  of  declaring  these  nodes  as  inputs  to  the 
circuit. 

20  to  2S  s  is  the  simplest  simulation  command  available.  It  runs  a  tingle  simulation  step  for  a 
predetermined  amount  of  time  (default  100ns)  or  until  the  entire  network  being 
simulated  has  settled  to  a  definite  state.  Rec^  in  our  set  up  phase  we  informed 
RNL  (chflag)  that  the  transition  times  of  the  nodes  in  and  out  ^ould  be  reported. 
Lines  25  and  26  show  these  transition  times  relative  to  the  current  time  reported  in 
24.  Transitions  of  nodes  that  are  set  by  I  etc.  are  assumed  to  happen  immediately 
hence  the  transition  time  of  0  in  line  25  for  node  in. 

27  to  31  When  the  simulation  step  is  completed,  s  uses  the  def-report  (line  U)  to  format  the 
results  of  the  step.  Line  27  is  of  course  the  string  we  wanted  to  have  printed,  the 
current  time  (ns)  is  then  given  (this  is  always  reported  and  need  not  be  included  in 
the  format  specification).  Line  30  details  the  current  states  of  all  the  nodes  that 
were  declared  in  the  def-report.  In  this  case  in  and  out  are  indeed  shown  to  be  an 
inverted  pair,  'done*  (line  31)  is  echoed  to  the  terminal  and  this  completes  one 
simulation  step.  If  a  def-report  was  not  specified  a  warning  to  that  effect  is 
displayed  and  then  'done.* 

32  to  43  This  sequence  is  very  similar  to  the  one  just  described,  b  is  the  analogous  function 
for  setting  nodes  to  a  logic  high  value.  Not  used  in  this  example  is  the  function  u. 
It  completes  the  set  by  declaring  nodes  to  'unknown.”  The  characteristics  of  nodes 
declared  unknown  are  discussed  in  Section  4  of  the  RNL  User’s  Guide.  The  results 
again  show  that  the  nodes  of  interest  are  indeed  a  inverted  pair. 

44  One  exits  the  simluation  by  either  typing  on  a  newline  the  one  of  the  strings  (exit) 
or  exit  or  by  entering  CNTL  O.  Exit  is  used  here  to  return  to  the  C  shell  of  UNIX. 

To  release  a  node  that  hu  been  declared  an  input  with  any  of  these  commands  one  uses 
the  X  command  followed  by  a  list  of  nodes.  Nodes  that  have  been  released  will  reflect  their 
*tnxe*  state  at  the  end  of  the  next  simulation  step.  The  choice  of  x  is  a  potential  source  of 
confusion  as  X  (capital  X)  is  used  to  represent  the  logic  state  of  unknown.  This  is  unfortunate 
but... 
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4.1.  RNL  Control  Fite 

For  simulationt  such  as  the  one  described  in  the  previous  section  all  of  input  can 
be  entered  while  in  interactive  mode.  As  simulations  become  larger  or  as  one  iterates  on  a 
design  the  need  for  a  set  of  frequently  used  commands  to  be  entered  without  retyping  grows 
rather  quickly. 

RNL  provides  such  a  capability  by  the  use  of  the  control  file.  The  commands  in  this  file 
are  eiecuted  upon  entry  into  simulation.  When  the  end-of-file  is  reached  control  is  returned 
to  the  user,  lliat  is  to  say  commands  like  the  ones  we  have  been  through  can  be  entered. 
What  are  typical  commands  put  in  the  control  file? 

In  the  cases  we  have  just  analyxed  the  following  file  would  reduce  our  efforts  consider* 

ably. 

;  All  teat  appearing  after  a  eemlceien  Is  a  comment  and  la  Igpored 
;  Rnl  control  fite  for  the  Inverter  eaampte 
(load  'nwstd  J') 

(load  'nwslmi^ 

(read-network  'Invertec^ 

(chflag  ’(!■  ont)) 

(def-report  ’(*Cnn«o<  State:*  newUno  In  out)) 

This  file  is  a  collection  of  the  setup  commands  tbm  we  issued  first  when  running  RNL  interae- 
tivly.  For  detailed  analysis  of  these  commands  the  reader  is  referred  to  the  previous  section. 
Note  the  use  of  the  comment  lines.  Comments  are  begun  with  a  semi-colon  (;)  and  all  text 
appearing  after  it  until  a  newline  is  ignored  by  RNL. 

4.1.1.  Using  the  RNL  Control  File 

The  only  requited  modification  to  the  start  up  of  RNL  is  to  add  the  name  of  the  file  that 
contains  the  RNL  commands  and  looks  like. 

%  ml  control_flte 

where  you  can  substitute  any  filename  that  suits  you  for  control_file.  When  using  a  control 
file  RNL  works  rather  quietly.  Below  you  will  see  the  output  from  the  control  file  described 
above. 

Loading  uwsimJ 
Done  loading  uwsimJ 

;  8  nodes,  transistors:  enh=0  intrinsic=0  p-chan»0  dep»0  low-power=0  pullup^  resutor^O 

Clearly  most  of  output  that  wu  generated  interactively  is  gone.  In  fact  we  are  left  with  only 
the  fact  that  uwsimJ  has  been  loaded  and  a  summary  of  the  preprocessed  network  from  the 
read-network  command.  As  shown  below  we  can  now  set  the  input  low  and  run  a  simulation 
just  as  was  done  before. 

lln 

done 

s 

Step  begins  @  0  ns. 
insQ  @  0 
out«l  @  0j6 
Current  state: 

Current  time»  100 
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in=0  out=l 
done 

A  useful  technique  to  develop  is  one  where  the  simulation  experiment  is  verified  interac¬ 
tively  and  is  then  followed  by  a  larger  simluation  run  in  batch  mode.  This  can  be  done  with 
the  use  of  the  control  file  by  adding  simulation  commands.  Some  care  must  be  used  here  as 
some  of  the  commands  require  a  slightly  different  syntax  when  used  in  batch  mode.  For 
example  when  nodes  are  to  be  set  at  some  input  value  (h,  I  etc.),  in  batch  mode  the  nodes 
must  be  in  the  form  of  a  quoted  list  (recall  ’(> )) 

(h  ’(■!  a2  b3)). 

the  command  to  run  a  simluation  step  must  also  have  the  special  quoted  list,  the  empty  list 

(i  ’O). 

This  is  the  result  of  the  RNL  Lisp  interpreter  having  a  special  form  only  for  interactive  com¬ 
mands.  The  discussion  of  this  is  in  section  S. 

4J.  Usafnl  Addltleas 

To  this  point  we  have  run  through  an  example  interactively  and  shown  how  one  can  con¬ 
dense  the  frequently  used  commands  into  an  RNL  control  file.  In  this  section,  additional 
commands  that  can  te  used  either  interactively  or  through  the  control  file  will  be  explored. 


A  very  common  situation  in  design  is  to  have  a  group  of  signals  that  work  togiethet  (i«. 
buses).  When  doing  simulation  it  would  be  most  useful  to  be  able  to  give  these  signals  a  name 
and  refer  to  the  whole  set  by  that  name.  The  uwsimJ  package  provides  this  through  a  set  of 
vector  commands.  An  example  (albeit  overly  simple)  of  this  would  be  to  define  the  nodes  in 
and  onf  in  the  inverter  example  as  a  vector.  This  is  done  with  the  following  command, 

(dcfvec  ’(bin  Inoatvcc  In  out)) 

The  template  for  this  command  is 

(dcfvec  ’(radix  name  list_of_oodes)) 

Dcfvac  is  the  command  name  and  notice  that  a  familar  piece  of  syntax  has  appeared  again,  the 
quoted  list  (begins  with  ’(  and  ends  with  )).  Radix  is  the  number  base  that  the  vector  will  be 
printed  in  when  you  request  that  it  be  displayed.  The  choices  are  the  familar  set,  bln  •> 
binary,  oct  •>  octal,  bse  •>  bsxadeelmal  and  dac  •>  daclaal.  List_of_nodes  can  be  any 
number  of  nodes  that  defines  the  vector.  In  our  case  there  are  2  in  and  ota. 

Vectors  are  a  special  data  type  that  are  composed  of  lists  of  nodes.  There  are  functions 
provided  for  setting  the  vector’s  value  (Invcc)  and  finding  out  how  a  vector  is  defined  (vec- 
naoMs).  These  functions  are  detailed  in  section  72  of  the  RNL  User’s  Guide.  The  handiest 
place  for  vectors  however  is  when  they  are  used  in  dat-repart. 


;  All  text  appearing  after  a  asmicoibn  ti  a  comment  and  Is  Igporcd  ;  (1) 

;  Ral  control  flla  for  the  inverter  example  ;  (2) 

(lof-nie  'inJoT)  ;  (3) 

(load  *BwstdJ*)  ;  (4) 

(load  'awsImJ^  ;  (5) 

(read-network  'InverteO  ;  (4) 

(cbfiag  ’(In  ant))  ;  (7) 
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(dervce  ’(bin  Ineatvcc  In  oat))  ;  (8) 

(d«f*rcport  '('Cnrrat  StaUS*  acwUao  (vce  taioatvcc)))  ;  (9) 

8  This  control  file  is  quite  similar  again  to  the  one  shown  earlier  but  now  on  line  8  we 
have  made  use  of  the  defvac  command.  In  this  case  the  radix  has  been  set  to  binary 
and  the  name  has  been  set  to  inoutvec.  The  signal  names  (nodes)  in  and  out  finish 
the  definition  at  the  vector. 

9  The  dcf'rcport  command  also  refiects  the  use  of  defvec.  Now  the  report  uses  vcc 
which  is  defined  to  print  the  value  of  the  named  vector  (e.g.  inoutvec).  Recall  in 
declaring  the  vector  we  specified  a  binary  radix.  Vcc  reports  the  vector  in  this  radix. 
This  format  replaces  the  individual  node  names  and  values  we  used  earlier.  Assum¬ 
ing  that  we  have  either  given  RNL  a  control  file  with  this  report  or  interactively 
declared  a  report  the  results  of  a  step  of  simulation  would  be 


I  In  ;  (1) 

done  ; (2) 

s  ;(3) 

;W 

Step  begins  @  0  ns.  ;  (S) 

in=0  @0  ;  (6) 

out-1  ®  0j6  ;  (7) 

Current  State:  ;  (8) 

Current  time=  100  ;  (9) 

;(io) 

inoutvec=0b01  ;  (11) 

done  ; (12) 


11  The  individual  nodes  and  values  have  been  replaced  by  the  vector  we  declared.  The 
name  and  the  current  value  of  the  vector  is  reported.  The  prefix  Ob  reflects  the 
radix  that  was  declared  when  the  vector  was  defined.  The  other  radix  flags  follow 
the  UNIX  convention  (0  •>  octal.  Ox  •>  hex).  One  can  also  mix  the  printing  of 
nodes  and  vectors  thus 

(def-report  ’('Camnt  State:*  newline  In  oat  (vcc  Inontvce))) 
would  be  another  way  we  could  format  the  report. 

4 J.  Event  files 

A  very  useful  command  for  displaying  and  interpreting  the  results  of  your  simulation  is 
openplot.  This  command  has  the  following  template 

openplot  *ploC_fllc_nanic* 

Note  there  are  no  parenthesis  surrounding  this  command  as  there  has  been  with  the  others 
that  have  been  discussed.  The  effect  of  issuing  this  command  is  that  ail  transitions  that  were 
requested  with  chflag  are  entered  into  the  file  plot_fiIe_name.  This  file  can  then  be  used  as 
input  to  programs  that  di^lay  the  time  series  trace  on  either  a  4010  compatible  terminal  or  a 
Printtonix  raster  printer.  The  details  of  the  use  of  these  programs  are  described  in  the  man 
pages  for  slmseope  and  mtp. 

At  the  end  of  the  simulation  the  file  is  closed  with 

closaplot  *plot_fUe_naiBe* 

Again  the  parentheses  are  not  used. 
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4.4.  Local  Network  Walka 

When  working  interactively,  two  commands  that  allow  local  areas  of  the  network  to  be 
examined  are  presented.  The  first  one  allows  the  user  to  obtain  all  transistors  that  are  gated 
by  the  node  in  question  and  any  sum-of-products  functions  of  which  it  is  an  input.  This  com¬ 
mand  will  be  referred  to  as  a  foward  refcrcnca.  The  second  command  reports  the  list  of 
transistors  for  which  the  node  is  either  the  source  or  drain  and  a  summary  of  its  sum-of- 
products  representation  if  any.  This  will  be  referred  to  as  backward  reference.  In  the  follow¬ 
ing  example  we  will  investigate  the  SR  latch  described  earlier  with  these  commands. 


IS  ;  (1) 

S=H  [NOTE:  node  is  an  input]  (vl^^OJO  vh-0.80)  (0.019200  pf)  affects:  ;  (2) 

input  to  functions  for  the  following  nodes:  ;  (3) 

1  ;(4) 

1  ;(5) 

done  ; (6) 

?  1  ;  (7) 

1=L  (vl=0J0  vh=0.80)  (0.062800  pf)  is  computed  from:  ;  (8) 

CMOS  ;  (9) 

(nor  (n-chan  (and  S^H  ))  resistance  [liX)e-t-04, 1.00e-H)4]  ;  (10) 

(p-chan  (and  S-H  ))  resistance  [SjOOe-i-Q3,  S.00e-M)3]  ;  (11) 

)  ;(i2) 

done  ;  (13) 

1 1  ;  (14) 

1=L  (vl=0J0  vh=0.80)  (0.062800  pf)  affects:  ;  (15) 

input  to  functions  for  the  following  nodes:  ;  (16) 

Q  ;  (17) 

Q  ;(18) 

done  ; (19) 

?  Q  ;  (20) 

Q=H  (vl=050  vh=0S0)  (0D12800  pf)  is  computed  from:  ;  (21) 

CMOS  ;  (22) 

(nor  (n-chan  (and  1=L  Q-=L  ))  resistance  [2.00e-K)4,  2.00e-t-04]  ;  (23) 

(p-chan  (and  1=L  ))  resistance  (LOOe-HN,  1.00e4-04]  ;  (24) 

(p-chan  (and  Q-=L  ))  resistance  [IDOe-t-Oi,  1.00e-H)4]  ;  (25) 

)  ;  (26) 

done  ;  (27) 

IQ  ;  (28) 

Q=H  (vl=0J0  vh=0.80)  (0J012800  pf)  affects:  ;  (29) 

input  to  functions  for  the  following  nodes:  ;  (30) 

Q-  ;(31) 

Q-  :(32) 

done  ;  (33) 

7Q-  ;(34) 

Q-»L  (vI=0J0  vh*=0S0)  (OJ012800  pf)  is  computed  from:  ;  (35) 

CMOS  ;  (36) 

(nor  (n-chan  (and  2=H  Q^H  ))  resistance  [2.00e-H)4, 2.00e-H)4]  ;  (37) 

(l^chan  (and  2=H  ))  resistance  [li)0e-t-04,  li)0e+04]  ;  (38) 

(p-chan  (and  Q=H  ))  resistance  [l.OOe-t-04,  l.OOe-t-04]  ;  (39) 

)  ;(40) 

done  ;  (41) 

*  Q*  ;  (42) 

Q-  =L  (vl  =0 JO  vh  =0 JO)  (0.012800  pf)  affects:  ;  (43) 

input  to  functions  for  the  following  nodes:  ;  (44) 
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Q 

Q 


done 


:(45) 

:(46) 

;(47) 


1  to  6  This  is  the  output  of  the  forward  reference  command  (/)  for  one  of  the  inputs  to  the 
SR  latch  described  earlier.  Line  2  summarizes  the  parameters  for  node  S.  Several 
things  should  be  observed  here.  First  note  that  this  node  is  considered  an  input. 
This  is  because  the  node  has  been  set  by  of  the  command  h.  Similarly  if  I  or  o  were 
used  this  messages  would  appear.  The  next  parameters  show  the  logic  threshold 
values  (voltage  is  normalized  to  IjO)  for  the  node.  For  a  discussion  of  these  values 
the  reader  is  referred  to  section  2  of  the  RNL  User’s  Guide.  Next  the  total  load 
capacitance  is  given  in  picofarads.  Finally  a  summary  of  all  nodes  that  this  node  is 
an  input  is  reported.  In  this  case  only  node  1  is  affected.  Recall  that  in  building  the 
SRlatch  we  used  local  nodes  for  the  output  of  the  inverters.  The  node  I  is  one  of 
tue  NETLIST  generated  nodes  we  talked  about.  If  there  were  transistors  that  this 
node  gated  they  would  be  reported  next.  The  template  for  a  transistor  report  is 

type  gate  source  drain  resistance_V8lues 
All  of  these  parameters  have  their  usual  meanings  (e.g.  resistance  in  ohms). 

7  to  12  We  can  continue  the  local  network  walk  with  a  backward  reference  (?)  for  node  /. 

Line  8  is  similar  to  the  forward  reference  but  note  how  this  node  is  not  an  input.  It 
is  computed  from  the  function  shown  in  lines  9  to  12.  This  is  what  a  summary  of  a 
CMOS  inverter  looks  like.  The  technology  is  indicated  in  line  8.  This  is  followed 
by  a  list  of  each  of  the  product  chains  in  the  sum-of-products  description.  Each  pro¬ 
duct  chain  is  prefixed  with  the  type  of  transistor  (n-chan  or  p-chan).  In  this  case 
each  product  chain  consists  of  just  the  one  input  5.  At  the  end  of  each  list  of  inputs 
a  summary  of  the  total  resistance  computed  by  PRESIM  is  given.  The  first  of  the 
two  resistance  values  is  used  in  computing  the  state  of  the  node  and  the  second  is 
for  estimating  the  delay  time  of  the  transition  if  any.  Details  are  given  in  the  RNL 
User’s  Guide  in  section  2.  Again  resistance  values  are  given  in  ohms. 

14  Pressing  on  with  the  forward  reference  1  of  node  /  we  find  that  it  is  the  input  to  the 

node  Q  (see  line  17). 

20  Node  Q  definition  is  then  obtained  with  a  backward  reference  ?.  The  function 
definition  follows  substaintially  the  same  form.  The  pulldown  product  tern  (It  is 
the  pulldown  product  because  it  is  formed  from  n  type  transistors.)  contains  2  inputs 
I  and  Q-.  The  pullup  is  composed  of  the  first  two  term  sum-of-products  encountered 
that  is,  the  two  single  term  pullup  products  are  ored  together  (7  or  Q-).  This  is  the 
general  form  for  nand  gates.  The  dual  of  this  combination  of  p  and  n  transistors 
would  be  the  pattern  for  a  2  input  nor  gate.  Again  each  term  is  followed  by  its 
resistance  values. 

28  This  is  the  forward  reference  for  the  node  Q-.  And  here  we  find  the  effects  of  the 
cross<oupled  nand  gates  forming  the  flip-flop  in  the  SR  latch.  Note  that  Q-  is  a 
function  of  Q  and  vise  versa  (see  line  45).  Also  the  other  local  node  from  the 
second  inverter  is  an  input  to  Q-.  Again  NETLIST  used  numeric  node  names  for 
these  nodes  and  such  names  should  be  avoided  elsewhere. 

From  this  example  then  we  have  shown  how  the  forward  and  backward  reference  com¬ 
mands  can  be  used  to  get  a  feel  for  where  a  node  lives  in  the  circuit.  This  is  particularly  use¬ 
ful  when  portions  of  the  circuit  appear  to  be  misbehaving.  These  commands  can  ensure  that  it 
indeed  is  'wired  up*  correctly. 


s  V 
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4J.  Sonmary 

This  completes  in  example  for  running  RNL.  This  example  is  by  no  means  exhaustive. 
In  fact  the  Lisp  command  interpreter  available  in  RNL  makes  the  possibilities  for  elaborate 
simulation  commands  very  attractive.  Recall  that  one  of  the  first  things  that  we  did  during 
our  session  was  to  load  the  files  uwstdi  and  uwsimJ.  These  files  represent  some  of  the  versa¬ 
tility  of  this  interpreter.  In  the  next  aectirm  we  will  examine  portions  of  these  files  for  exam¬ 
ples  <rf  how  one  might  constmct  their  own  commands. 

5.  RNL  LISP:  SOME  EXAMPLES 

This  section  is  a  tutorial  introduction  by  examples  to  programming  in  RNL  Lisp.  The 
particular  examples  chosen  are  taken  directly  frm  the  package  uwsimJ.  They  were  chosen  to 
be  instructive  not  only  from  the  standpoint  of  being  examples  of  Lisp  functions,  but  also 
because  they  are  prototypical  of  the  kinds  of  functions  that  a  user  may  want  or  need  to  write. 
We  are  deliberately  encouraging  users  to  write  their  own  user  interface  functions  by  copying 
these  examples  and  modifying  them. 

5.1.  The  RNL  Ugp  Interpreter. 

In  order  to  discuss  the  writing  of  Lisp  functions  we  first  present  a  brief  introduction  to 
the  Lisp  language  and  the  Liq:  interpreter.  If  at  first  you  do  not  understand  what  is  going  on 
we  recommend  the  following  strategies:  study  the  examples,  reread  this  section  carefully,  and, 
most  importantly,  play  with  RNL  interactively.  Because  Lisp  is  interactive  you  can  often 
team  a  lot  more  in  a  few  minutes  of  hands  on  eqwrimentation  than  in  hours  of  staring  at 
textbooks  and  manuals.  The  'real*  Lisp  systems  that  most  resemble  RNL  Lisp  are  MACUsp 
(from  MIT)  and  the  Fraiix  Lisp  (from  Berkeley).  If  you  do  consult  other  texts  and  manuals, 
ones  that  use  either  of  these  dialects  will  be  the  most  useful. 

It  has  been  claimed  that  rather  that  standing  for  *LISt  Processing*  that  Lisp  is  really  an 
acronym  for  'Lots  of  Irritating  Single  Parentheses^.  Although  the  Lisp  syntax  is  simple, 
elegant,  and  powerful,  it  has  the  unfortunate  property  that  a  user  can  easily  wind  up  wasting 
time  trying  to  balance  parentheses  and  trying  to  understand  poorly  formated  Lisp  code. 
There  are  two  things  that  one  can  do  to  minimize  this  problem.  The  first  is  to  use  care  in  for¬ 
matting  your  Lisp  functions.  Don’t  put  too  much  on  one  line  and  use  a  consistent  indentation 
style.  The  second  thing  that  you  can  do  is  to  use  a  screen-oriented  text  editor  with  a  Liq> 
mode  (e.g.  EMACS)  that  helps  you  to  keep  track  of  the  parentheses  and  indentation. 

5.1.1.  Evaloatlen 

Perhaps  the  most  fundamental  concept  in  Li^  is  the  evaluation  of  a  Lisp  object.  Lisp 
objects  are  also  known  as  J-e^rrrWoiu  (The  ”S*  stands  for  'symbolic”.)  and  we  will  often  just 
call  them  'expressions*.  The  universe  of  Lisp  objects  is  divided  into  two  classes:  primitive 
objects  (also  known  as  'atoms'),  and  lists. 

In  RNL  Litp  there  are  several  kinds  of  primitive  object: 

symbols  are  like  variables  in  other  programming  languages.  Each  symbol  potentially  has  a 
value,  a  functional  definition,  and  a  list  of  properties.  In  addition,  it  has  a  print  name 
by  which  it  is  known,  both  on  input  and  output.  Usually  print  names  are  terminated 
'white  space*  (spaces,  tabs,  and  newlines),  but  print  names  containing  these  and 
other  special  characters  can  be  entered  by  quoting  the  name  with  vertical  bats  (e.g. 
llong.name  with  white  spacel  is  a  symbol). 

numbers  can  be  integers  or  floating  point  numbers. 

strings  are  pieces  of  text  surrounded  by  double  quotes  (e.g.  'this  string”). 

nodes  correspond  to  the  electrical  nodes  of  the  circuit  you  are  simulating.  This  is  a  data 
type  not  found  in  other  dialects  of  Li^.  The  print  names  of  nodes  can  resemble  sym¬ 
bols  or  numbers.  If  a  symbol  or  number  is  used  where  a  node  is  expected  then  RNL 
automatically  tries  to  convert  to  the  node  with  a  similar  print  name.  In  addition. 
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nodes  can  be  named  as  lists  of  the  form  (-struet-  a  b  e  etc)  where  each  of  a.  b,  e,  etc. 
are  either  symbols  or  intefers.  Lists  like  this  name  nodes  with  nan.ss  like  ah£Mc. 
This  allows  you  to  create  hierarchically  structured  naming  schemes  for  your  circuits. 
If  you  try  to  enter  ahtjete  then  the  RNL  interpreter  will  convert  it  to  a  list  rather 
than  a  symbol,  so  if  you  want  to  have  symbols  with  periods  in  their  print  names  you 
have  to  use  the  verti^  bar  convention,  e^.  \ah£Me\. 

A  List  is  a  sequence  (a  list)  of  Lisp  object  that  is  bracketed  with  parentheses.  Lists  can 
and  do  contain  other  lists.  For  historical  reasons  the  first  element  of  a  list  is  known  as  the 
'cat*  of  the  list  and  there  is  a  function,  ear  that  extracts  it  from  a  list.  The  list  formed  by 
removing  the  car  is  known  as  the  'cdt*  (pronounced  *\oo-def*)  and  is  extracted  using  the 
function  edr. 

Example:  ((a  b)  (c  (d))  e) 

This  is  a  list  of  three  elements.  The  first  element  (the  car)  is  the  list  (a  b).  The  second  ele> 
ment  is  the  list  (e  (d)),  and  the  last  is  the  symbol «.  The  edr  is  the  list  ((e  (d))  *).  Note  that  in 
the  second  element  that  {d)  is  a  list  of  one  element,  not  a  symbol.  Note  also  that  the  edr  of 
(fe  (d))  t)  is  the  list  (e)  (ije.  (e  (d))  is  one  element  of  the  original  list).  The  edr  of  (e)  is  the 
empty  list  0*  ‘The  empty  list  is  synonymous  with  the  qnnbol  nit. 

That  is  all  there  is  to  Lisp  data  structures:  atoms  and  lists.  From  these  you  build  data  struc¬ 
tures,  function  definitions,  and  commands  to  the  interpreter. 

5.U.  Evalaattoa 

The  central  idea  in  the  execution  of  Lisp  programs  is  that  of  the  evaluatUm  of  Liq> 
objects  (expressions).  Evaluation  is  a  proeesa  that  interprets  a  Lisp  object  and  returns  some 
other  Lisp  object,  its  value.  The  evaluation  process  can  have  side  effects. 

The  evaluation  of  atoms  is  straightforward.  When  a  symbol  is  evaluated  the  object  the 
interpreter  returns  is  the  one  that  was  most  recently  assigned  to  be  the  symbol’s  value.  In 
other  words,  a  symbol  acts  just  like  a  variable  in  other  programming  languages.  All  the  other 
types  of  atoms  (numbers,  strings,  and  nodes)  are  what  is  called  'self-evaluatingT-  That  is,  these 
objects  and  their  values  are  identical. 

The  evaluation  of  lists  is  a  little  more  complicated.  In  the  interest  of  completeness  we 
will  give  all  the  gory  details  here,  but  keep  in  mind  that  the  simplest  case  is  the  most  common. 
Usually  lists  are  function  calls,  but  sometimes  they  are  what  are  called  'special  forms'.  In  all 
cases,  the  car  (first  element)  of  the  list  being  evaluated  controls  what  will  happen. 

If  the  car  of  the  list  being  evaluated  is  a  symbol  then  the  interpreter  checks  whether  it 
has  a  function  definition.  If  not,  then  the  interpreter  evaluates  the  symbol  and  uses  the 
result  as  though  it  were  the  original  car  of  the  lift. 

If  the  car  is  an  atom  other  than  a  symbol  then  this  is  an  error  because  these  types  of 
atom  cannot  have  function  definitons. 

If  the  car  of  the  list  being  evaluated  is  itself  a  list  then  the  interpreter  first  checks  to  see 
whether  it  is  a  function  definition  (see  below).  If  it  is  not  a  function  definition,  then  it 
is  evaluated  and  the  result  is  used  as  though  it  were  originally  the  car  of  the  list. 

In  this  way,  the  interpreter  repeatedly  (recursively)  evaluates  the  car  of  the  list  being 
evaluated  until  a  function  definition  is  found.  Although  this  sounds  complicated,  the  simplest 
case  in  which  the  car  is  a  symbol  with  a  function  definition  is  the  most  common  form  and  all 
other  forms  are  extremely  rare  in  circuit  simulation  applications. 

5.U.  Faactloa  Deflaltieas 

Function  definitions  come  in  two  flavors.  There  are  the  built-in  functions  (including  spe¬ 
cial  forms)  and  there  are  user-defined  functions.  If  you  should  print  one  of  the  former  it 
would  appear  to  be  a  funny  symbol  such  as  ib566506.  This  indicates  that  the  symbol  is  a 
built-in  function  or  special  form. 
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A  user  defined  function  definition  appears  as  a  list  that  looks  like: 

(lambda  (*  y)  (+  3  (•  *  y))) 

The  symbol  lambda  is  a  special  symbol  that  means  *This  list  is  a  function  definition.  Do  not 
continue  evaluation*.  The  list  *(z  y)*  names  the  symbols  that  act  as  the  formal  parameters  to 
the  function.  The  remainder  <rf  the  list  is  the  body  of  the  function  and  is  composed  of  a 
sequence  of  Lisp  expressions  (objects)  that  are  evaluated  in  left-to-right  order  when  the  func¬ 
tion  is  evaluated.  The  particular  function  defined  above  returns  a  value  three  greater  than  the 
product  of  its  two  parameters. 

Thus  far  in  our  narrative  the  interpreter  has  reduced  the  car  of  the  list  it  is  evaluating  to 
a  function  definition.  If  this  is  an  ordinary  function  definition  then  the  next  step  is  the 
evaluation  of  the  arguments  to  the  function.  Each  of  the  remaining  elements  of  the  list  is 
interpreted  as  an  argument  to  the  function.  They  are  evaluated  in  left-to-right  order  and  the 
objects  returned  are  used  as  the  values  of  the  formal  parameters  of  the  function. 

Finally,  the  body  of  the  function  is  evaluated  using  these  parameter  values  and  the  value 
returned  is  the  last  value  returned  when  the  body  is  evaluated. 

Let  us  look  in  detail  at  the  evaluation  of  the  following  expreaaion: 

((lambda(xy)(+3Cxy))8k) 

The  interpreter  goes  through  the  following  steps: 

1.  First  the  ear  of  the  list  is  found  to  be  a  user-defined  definition  of  a  function  with  two 
parameters  called  x  and  y. 

2.  The  next  element  in  the  list  is  evaluated.  It  is  the  integer  8  and  is  thus  self-evaluating. 

3.  The  last  element  in  the  list  is  the  symbol  k.  Suppose  that  its  value  is  S. 

4.  Because  x  and  y  are  the  formal  parameters  of  the  function,  their  values  are  set  to  8  and 
S  respectively  when  the  function  is  entered.  When  the  function  is  exited  the  values  they 
held  previously  will  be  restored. 

5.  The  body  of  the  function  *(-!■  3  (*  x  y))*  can  now  be  evaluated: 

a.  The  s)rmbol  +  is  found  to  have  a  built-in  function  definition  and  the  first  argument 
evaluates  to  3. 

b.  The  second  argument  to  -t-  is  the  list  *(*  x  yf.  When  it  is  evaluated  a  built-in 
definition  is  found  for  multiplication,  x  has  the  value  8,  and  y  has  the  value  S.  The 
expression  '(*  x  y)*  therefore  evaluates  to  40. 

c.  Both  of  4-’s  arguments  are  now  evaluated  so  the  addition  can  proceed,  returning  43. 
This  completes  the  evaluation  of  the  body  of  the  function. 

6  Since  the  last  value  returned  in  the  evaluation  of  the  body  of  the  function  is  43,  this  is 
also  returned  u  its  own  value. 


5.1.4.  Fnnetleas  Versus  Special  Forms. 

When  a  user-defined  function  is  encountered  as  the  car  of  a  list  all  of  the  remaining  ele¬ 
ments  of  the  list  are  evaluated  and  the  results  passed  to  the  function  as  arguments.  Further¬ 
more,  the  number  of  formal  parameters  in  the  function  definition  and  the  number  of  argu¬ 
ments  actually  passed  must  agree. 

The  built-in  function  definitions  do  not  have  the  same  restrictions.  Some  functions  can 
take  a  variable  number  of  arguments.  An  example  is  the  -t-  function.  It  returns  the  sum  of  an 
arbitrary  number  of  arguments.  There  are  other  built-in  functions  that  do  not  evaluate  one  or 
more  of  their  arguments.  An  example  of  this  is  the  satq  function  that  is  used  to  set  the  value 
of  a  symbol.  Evaluating  the  list 

(setq  syml  (foo  a  b  c)) 
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has  the  side  effect  of  setting  the  value  of  its  unevaluated  first  argument  (in  this  case,  the  sym¬ 
bol  symt)  to  the  result  of  evaluating  its  second  argument.  This  is  also  the  value  returned  by 
the  satq  function. 

Other  symbols  have  built-in  definitions  that  do  not  act  at  aU  like  functions.  These  are 
called  'special  formsT.  For  example,  the  lambda  symbol  is  a  special  form  that  indicates  func¬ 
tion  definition.  Other  special  forms  are  used  to  define  program  control  structures.  While 
these  qyecial  forms  may  return  values  analagously  to  functions,  their  interpretation  is  very 
different  from  that  described  above.  For  example,  evaluating  the  list 

(defun  crunch  (x  y)  (+  3  (•  x  y))) 

has  the  side  effect  of  setting  the  function  definition  of  the  symbol  eruach  to  the  list: 

(lambda  (x  y)  (+  3  (•  x  y))) 

In  this  case  none  of  the  elements  of  the  list  are  evaluated  as  arguments.  (The  result  returned 
in  this  example  is  the  symbol  eruach.) 

The  quote  special  form  is  especially  useful.  It  returns  its  argument  without  evaluating  it. 
That  is,  if  you  want  an  object  rather  than  its  value  you  can  use  quote  to  inhibit  evaluation. 
This  is  so  useful  that  it  has  its  own  special  alternate  input  syntax  .  The  form  ’ebj  is  translated 
to  (qnoM  ebJ)  where  ebJ  can  be  any  Lisp  object.  For  example,  if  you  type  the  expression: 

(setq  a  ”(x  y  x)) 

to  the  interpreter  (note  the  two  single  quotes),  then  it  will  return  the  object: 

(quote  (x  y  2)) 

Because  the  self-evaluating  objects  (numbers,  strings,  and  nodes)  do  not  need  to  be  quoted, 
they  are  also  sometimes  referred  to  as  'self-quoting*. 

5J.  The  *Top-Levei  Leap* 

Now  that  we  have  introduced  the  data  structures  and  the  idea  of  evaluation  in  Lisp,  we 
proceed  to  introduce  the  user  interface  to  the  RNL  Lisp  interpreter.  The  interface  is  called 
the  'top-level  loop*  and  consists  of  the  following: 

1.  Read  a  Lisp  object  from  the  current  input. 

2.  Evaluate  the  object  read  in  step  1. 

3.  If  the  current  input  is  the  terminal  then  print  the  result  of  step  2. 

4.  Go  to  step  1. 

The  input  to  the  interpreter  is  buffered  on  a  line  by  line  basis.  Thus.  RNL  does  not  see 
anything  you  have  typed  until  you  enter  a  'newline*  and  you  can  use  the  standard  'within 
line*  editing  of  the  system  keys  to  modify  the  input  before  you  enter  it.  Even  though  you 
have  completed  a  line,  RNL  might  not  have  read  a  complete  Lisp  object  and  therefore  might 
not  respond  to  you.  For  example,  suppose  you  enter  the  lines 

(+3 

(••5)) 

43 

(We  use  the  convention  that  user  input  is  displayed  in  bold  type.)  After  you  enter  the  second 
line  RNL  responds  by  evaluating  the  expression  and  printing  the  result,  the  number  43.  Note 
that  it  did  nothing  after  you  entered  the  first  line  because  it  had  not  read  a  complete  Lisp 
object  at  that  point. 

In  order  to  reduce  the  number  of  parentheses  you  have  to  type,  RNL  Lisp  has  a  special 
alternative  syntax  you  can  use.  If  the  flnt  thing  on  a  line  is  a  symbol  then  RNL  interprets  it 
as  a  function  name,  creates  a  quoated  list  out  of  the  rest  of  the  line,  and  passes  that  list  as 
the  only  argument  to  the  function.  For  example,  the  following  two  lines  of  input  are 
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interpreted  identically  because  the  'reader*  of  the  top-level  loop  converts  the  second  line  into 
the  first  line.  (LaBglh  counts  the  number  of  elements  in  a  list.) 

(length  ’(a  b  c  (4  5)  3  25  MEO) 

7 

length  a  b  c  (45)  3  2SS.0E4 

7 

You  should  remain  aware  that  if  you  are  using  this  alternative  syntax  that  the  entire  command 
must  be  on  a  single  line.  While  this  is  convenient  for  invoking  tome  kinds  of  functions  it  does 
make  it  awkward  to  find  the  value  of  a  symbol.  Consider  the  following  sequence: 

(setqa23) 

23 

a 

illegal  function  object 
23 

(eval  *1) 

23 

Because  of  the  alternate  S3mtax,  when  we  tried  to  get  the  interpreter  to  evaluate  the  symbol  a 
as  an  expression,  the  'reader*  actually  created  the  list 

(■•0) 

and  that  is  what  wu  evaluated.  The  function  aval  evaluates  its  argument  an  extra  time,  so 
passing  a  quoted  symbol  to  it  results  in  only  one  evaluation  being  done. 

The  discussion  of  evaluation  in  the  previous  section  covets  the  case  in  which  everything 
works.  Inevitably,  however,  there  will  be  errors  such  as  the  one  above  in  which  no  function 
definition  was  found  for  the  symbol  a.  Whenever  an  error  like  this  is  detected  an  error  mes¬ 
sage  is  printed  and  all  current  attempts  to  evaluate  Lisp  objects  are  aborted.  This  leaves  you 
back  in  the  top-level  interactive  *read-eval-print*  loop.  A  particularly  troublesome  aspect  of 
this  is  that  if  an  error  is  detected  while  you  are  using  the  load  function  to  read  a  command 
file  that  the  load  itself  is  terminated  by  the  error  so  that  the  remainder  of  the  file  will  not  be 
read. 

Note  that  the  result  of  evaluating  a  command  is  printed  only  when  input  is  being  taken 
from  the  standard  input.  This  may  make  it  difficult  to  locate  errors  in  command  files  that  are 
being  'loaded*. 

6.  EXAMPLES  FROM  mvWmi 

To  make  things  clearer  we  proceed  to  look  at  some  examples  taken  directly  from  uwsimJ. 
These  examples  are  augmented  with  line  numbers  in  square  brackets  at  the  left.  These 
numbers  are  not  part  of  the  code  but  have  been  added  for  the  purposes  of  this  presentation. 

While  a  large  part  of  most  command  files  is  the  definition  of  functions  and  data  struc¬ 
tures  that  will  be  used  later,  part  of  all  command  files  is  the  initialization  of  'global*  symbols 
that  parameterize  those  functions. 

[1]  (setq  incr  1000) 

[2]  (setq  switch-level  nil) 

[3]  (setq  relative-timing  t) 

These  three  commands  use  the  setq  function  to  set  the  default  values  of  parameters  that  are 
used  to  control  your  simulation.  Line  1  sets  the  value  of  the  symbol  Incr  to  1000  RNL  time 
units  (IOOjO  nano-seconds).  Line  2  ensures  that  the  simulator  will  use  the  RC  model  for  simu¬ 
lation  rather  than  the  unit  delay  switch  model  and  line  3  sets  a  flag  that  forces  the  step  func¬ 
tion  (see  below)  to  report  simulation  times  relative  to  the  start  of  the  simulation  step.  These 
lines  illustrate  the  concept  of  self-evaluating  objects.  The  number  1000  evaluates  to  itself. 
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The  two  symbols  all  and  t  are  predefined  by  the  Lisp  interpreter  so  that  they  are  their  own 
values.  In  addition,  nil  has  the  semantics  of  being  identical  to  the  empty  list,  (). 

::  run  a  simulation  step  and  print  a  report  at  the  end 

[1]  (defun  s  (dummy) 

[2]  (step  incr) 

[3J  (wr-rcport) 

W  ) 

This  example  illustrates  the  definition  of  the  function  s  used  in  section  4.  The  function  s  does 
not  add  any  real  power  to  the  user  interface,  rather  it  serves  the  purpose  of  reducing  the 
amount  of  typing  you  need  to  do.  This  runs  the  simulation  for  a  time  increment  of  the 
current  value  of  the  symbol  Incr  and  then  calls  the  function  wr-raport  with  no  arguments  to 
write  out  a  summary  report  at  the  end  of  the  step. 

Note  that  s  has  a  dummy  parameter  called  dnmmy.  This  is  because  s  is  intended  to  be 
used  interactively  using  RNL  Lisp’s  alternate  syntax.  When  you  type  V  on  a  line  by  itself 
without  any  parentheses,  the  reader  converts  it  to  the  list  (r  ’()).  In  order  for  s  to  work 
correctly  it  must  expect  to  see  one  argument  even  thouj^  that  argument  will  be  ignored. 

(defun  prinnum  (base  num)  ;  only  called  to  bind  the  right  val  to  base 
(princ  num)) 

The  function _ prinnam  is  used  by  various  other  functions  in  the  itwilmJ  package.  Its  job  is 

to  print  an  integer  in  the  radix  specified  by  bare.  The  Liap  printing  routines  use  the  current 
value  of  Kue  to  control  the  radix  used  for  output.  By  naming  one  of  the  parameters  of 

_ prlnnnm  base  we  use  the  argument  binding  mechanism  of  RNL  Liq>  to  temporarily  change 

the  value  of  base  to  the  desired  value.  When  prine  is  called,  this  is  the  value  it  uses.  When 
_ prlnnnm  returns  the  previous  value  of  base  is  restored. 

This  example  illustrates  the  principle  of  dynamic  variable  scoping  in  Lisp.  Programming 
languages  such  u  C  or  Pascal  have  what  is  known  as  a  textual,  or  static,  scope  rule  for  the  use 
of  local  variables.  That  is,  the  part  of  a  program  that  sees  a  particular  local  variable  is  stati* 
cally  limited  to  the  text  of  the  routine  in  which  it  is  defined.  In  contrast.  Lisp  uses  a  dynamic 

scope  rule.  When  a  Lisp  special  form  (04.  a  fonction  definition)  uses  a  symbol  as  a  local 

variable*  (e.g.  a  parameter),  then  the  old  value  of  the  qrmbol  is  mved  away  and  is  restored 
only  when  the  special  form  returns.  Any  functions  that  are  called  before  the  special  form 
returns  will  see  the  new  value  of  the  symbol.  Furthermore,  any  changes  made  to  the  value  of 
the  symbol  will  be  lost  when  the  old  value  is  restored. 

;  chfiag  sets  the  STOPONCHANGE  flag  for  the  nodes  in  1 

[1]  (defun  chflag  (1) 

[2]  (do  ((here  1  (cdrhete))) 

[3]  ((nuU  here)  1) 

[4]  (stopsm*change  (car  here)  t) 

[51  )) 

The  function  chflag  takes  u  an  argument  a  list  of  nodes.  It  sets  the  STOPONCHANGE 
flag  for  each  of  the  nodes  in  the  list.  We  use  it  as  an  example  to  introduce  the  da  special  form 
and,  in  particular,  to  show  how  a  da  is  typically  iused  to  perform  a  function  on  each  of  the  ele¬ 
ments  in  a  list.  Note  that  although  chfiM  has  ihst  the  one  argument  (the  list  /)•  the  list  itself 
is  not  of  flxed  length. 

Line  1  deflnes  chflag  to  be  a  function  with  a  single  argument  called  I.  Line  2  begins  a 
da  form.  A  da  is  a  generalized  iteration  construct  that  allows  you  to  define  multiple  local 
symbols  to  be  used  in  the  iteration.  While  a  repeat  increments  its  single  local  symbol  on  each 
iteration,  a  da  allows  arbitrary  computations  to  be  done  on  to  get  the  new  values  of  its  local 
symbols. 
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The  first  thing  that  follows  the  do  is  the  list  of  local  symbol  declarations.  In  this  case 
there  is  only  one  element  in  that  list,  the  declaration  of  here.  A  declaration  is  a  list  of  one  to 
three  elements.  The  first  element  is  a  symbol,  in  this  case  here.  The  second  (optional)  ele¬ 
ment  of  the  declaration  is  evaluated  to  get  the  initial  value  for  the  symbol,  in  this  case  return¬ 
ing  the  value  of  1.  The  third  (optional)  elemmit  in  the  declaration  list  is  an  expression  that  is 
evaluated  at  the  beginning  of  each  successive  iteration  and  whose  result  then  becomes  the 
value  of  the  symbol  at  the  start  of  that  iteration.  In  this  case  it  is  '(edr  here)*.  Thus,  here  is 
defined  to  initially  be  the  original  list  of  nodes  and  on  each  successive  iteration  here  is  shor¬ 
tened  by  dropping  the  current  first  element. 

The  next  thing  in  a  do  following  the  declarations  list  is  an  'exit  clause*.  This  is  on  line  3. 
An  exit  clause  consists  of  a  list  of  expressions.  The  first  expression  (sometimes  called  the 
predicate)  in  this  list  is  evaluated  at  the  start  of  each  iteration.  In  this  case  it  is  the  expression 
(milt  here).  In  Lisp  'true*  means  'anything  other  than  mT.  When  a  built-in  function  has  to 
return  a  value  meaning  'true*  it  uses  the  symbol  r.  but  any  non-ni/  Lisp  object  will  do.  When 
the  value  of  the  predicate  of  the  exit  clause  becomes  true  (think  of  it  as  'non-ni/*)  then  all  of 
the  expressions  in  the  rest  of  the  exit  clause  are  evaluated  in  left-to-right  order  and  the  loop  is 
exited,  returning  the  value  of  the  last  expression  in  the  exit  clause.  In  the  example,  the  pr^i- 
cate  (null  here)  will  be  true  when  here  becomes  nit  (the  null  or  empty  list),  that  is.  when  we*ve 
removed  all  of  the  node  elements.  The  last  expression  in  the  exit  clause  is  the  symbol  /,  so  the 
loop  returns  its  value.  Since  the  do  is  the  last  (only)  expression  in  the  definition  of  the  chflag 
function,  the  value  of  i  is  also  the  value  returned  by  it. 

The  remainder  of  the  do  form  is  a  sequence  of  expressions  that  are  known  as  the  body 
of  the  loop.  The  expressions  of  the  body  are  evaluated  on  each  iteration  in  which  the  predi¬ 
cate  of  the  exit  clause  is  nil.  In  the  example  the  body  is  the  single  expression  that  is  a  call  to 
the  primitive  function  atop-en-change  with  the  car  (its  first  element)  ^  here  as  the  first  argu¬ 
ment  and  with  t  as  the  second.  This  has  the  effect  of  flagging  the  node  so  that  the  simulation 
is  halted  whenever  the  node  changes  state  so  that  the  event  can  be  reported  or  some  other 
special  action  can  be  taken. 

;  Run  a  simulation  step,  reporting  transitions 

[1]  (defun  step  (incr) 

[2]  (printf  *0tep  begins  ®  %S  nsD  (/  (float  current-time)  10.0)) 

[3]  (do  ((stop-time  (-t-  incr  current-time))  (savex  (*  current-time  1)) 

W  (n  t)) 

[5]  ((null  n)) 

[6]  (setq  n  (cond  (switch-level  (switch-step  stop-time)) 

[7]  (t  (sim-step  stop-time)))) 

[8]  (cond  (n  (dpy-node-trans  n) 

[9]  (printf  *®  %S0 

[10]  (/  (cond  (relative-timing  (-  current-time  savex)) 

[11]  (t  (float  current-time))) 

[12]  10))) 

[13]  (t  nU))) 

[Ml  ) 

The  function  step  is  interesting  to  look  at  for  a  couple  of  reasons.  It  is  the  function  that 
one  uses  to  simulate  a  circuit  for  a  particular  time  increment  and  is  therefore  worth  knowing 
about  both  for  having  an  undemanding  of  what  is  going  on  and  also  in  case  one  wants  to 
modify  it.  It  also  contains  a  more  complicated  example  of  a  do  as  well  as  introducing  the  cond 
special  form.  The  flm  thing  done  (line  2)  is  to  print  out  the  current  elapsed  simulated  time  in 
nanoseconds. 

The  RNL  provided  simulation  primitives  (dm-stap  and  switch-step)  both  operate  by 
advancing  the  simulated  time  until  either  the  specified  stop  time  is  reached  (returning  nil  in 
this  case),  or  until  some  circuit  node  that  has  been  flagged  changes  state  (returning  the  node 
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that  changed).  The  function  step  uses  these  primitives  to  run  the  simulation  for  the  fixed  time 
increment  specified  in  the  parameter  Incr.  Once  the  beginning  time  is  printed,  the  body  of 
the  function  is  loop  implemented  with  a  da.  On  lines  3  and  4  the  local  variables  are  defined. 
?tap  flaw  is  initialled  to  be  the  time  to  stop  the  simulation  step,  saves  is  initialized  to  be  the 
time  at  which  the  step  started,  and  n,  which  arill  be  used  to  hold  the  value  returned  by  each 
call  to  the  appropriate  simulation  primitive,  is  initialized  to  t.  Since  the  simulation  primitives 
return  all  when  the  qtpropriate  stop  time  is  reached,  (null  n)  is  used  as  the  predicate  (line  S) 
of  the  exit  clause  for  the  loop. 

Lines  6  and  7  are  the  call  to  the  simulation  step.  A  cend  special  form  consists  of  the 
symbol  eand  followed  by  a  number  of  lists  of  expressions  known  as  clauses.  These  are  similar 
to  the  exit  clause  of  a  do.  In  a  eand  the  clauses  are  examined  in  left-to-iight  order.  For  each 
clause,  the  predicate  is  evaluated  and  if  it  is  true  (returns  other  than  nit)  then  the  rest  of  the 
expressions  in  that  clause  are  evaluated  and  the  eand  is  exited,  returning  the  value  of  the  last 
expression  evaluated.  In  the  eand  on  lines  6  and  7,  tf  awltclt>lavel  is  not  nil  then  swltcli*stcp  is 
called,  otherwise  (since  the  value  of  i  is  /)  aloMtsp  is  called.  Since  the  value  returned  a 
cend  is  the  last  value  computed  in  the  clause  that  is  executed,  the  value  returned  by  this  toad 
will  be  the  value  returned  by  the  appropriate  amulation  primitive.  This  value  is  either  a  node 
with  its  STOPONCHANGE  flag  set  or  nil  and  the  watq  on  line  6  makes  it  the  value  of  n. 

The  first  clause  of  the  cend  on  line  8  is  executed  if  the  value  of  n  is  not  nil.  It  first 
passes  a  to  the  function  dpy*nede*tmas  and  then  prints  the  current  time,  either  relative  to 
the  start  of  the  step  or  in  absolute  terms,  depending  on  the  value  of  the  qnnbol  rdatlvw 
timing.  The  default  clause  (line  13)  is  included  just  for  readability. 

To  summarize,  the  body  of  slap  repeatedly  calls  a  simulation  primitive  until  that  primi* 
tive  returns  a  nil  to  indicate  that  the  desired  termination  time  has  been  reached.  Each  time 
the  simulation  primitive  does  not  return  nil  it  is  because  a  flagged  node  changed  state,  and  a 
reporting  function  is  called. 

;;  run  n  clock  cycles 

[1]  (defun  c  (n) 

[2]  (cond  ((eq  n  nil)  (setq  n  1)) 

[3]  ((not  (numberp  n))  (setq  n  (car  n)))) 

[4]  (do  ((index  0  (l-t-  index)) 

[51  (iO)) 

[6]  ((»■  index  n)  (wr-report)) 

[7]  (set-node  ’phil  1) 

[8]  (set-node  ’phi2  0) 

[9]  (step  incr) 

[10]  (set-node  ’phil  0) 

[11]  (step  incr) 

[12]  (set-node  'phi2  1) 

[13]  (step  incr) 

[14]  (set-node  *^1112  0) 

[15]  (step  incr)) 

[16]  ) 

The  function  c  runs  the  simulation  for  one  or  more  cycles  of  a  two  phase  (four  interval)  non¬ 
overlapping  clock  defined  using  the  predefined  node  names  'phil*  and  ”phi2*.  This  is  written 
to  take  advantage  of  RNL  Lisp’s  alternate  input  syntax.  The  symbol  n  will  be  the  number  of 
cycles  to  simulate. 

The  csnd  in  line  2  is  used  to  set  n  to  tho  correct  value.  The  first  clause  sets  the  count  to  I 
if  the  argument  to  e  i»  the  empty  list  (nil)  u  would  be  the  case  if  the  command  were  entered 
by  typing  *c*  on  a  line  by  itself.  The  second  clause  is  used  to  differentiate  between  the  cases 
of  calling  c  using  the  standard  parenthesized  syntax  (e.g.  *(c  S  )”)  or  the  interactive  syntax  (e.g. 
'c  S*  on  a  line  by  itselO- 
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The  rest  of  the  body  of  c  is  a  simple  do  loop  that  uses  lodes  as  the  loop  index  to  count  o 
clock  cycles  and  call  wr>rcpert  when  it  exits.  Lines  7  through  IS  handle  the  mechanics  of  rais¬ 
ing  and  lowering  the  clock  lines  as  appropriate  and  advancing  the  simulated  time  by  calling 
■tcp.  If  the  circuit  you  are  simulating  uses  a  different  clocking  discipline  then  you  should 
write  your  own  'clock  cycle*  function  analagoua  to  c.  The  code  for  c  provides  a  reasonable 
tenqilate  to  modify  for  your  own  needs. 

;  unchanged'Since  returns  a  list  of  the  nodea  that  are  unchanged  since  time. 

[1]  (defun  unchanged'Sinee  (time) 

[2]  (prog  (uc-list) 

[3]  (walk-net  ’(lambda  (n) 

[4]  (cond  ((<  (node-time  n)  time) 

|s]  (setq  uc-list  (cons  n  uc-list))) 

[6]  (t  uc-list) 

[7]  )) 

[81  ))) 

The  function  nnchangad-dnce  introduces  some  new  Lisp  constructs  and  also  illustrates  the 
usefulness  of  the  walk-net  primitive  when  you  want  to  examine  all  the  nodes  in  your  circuit. 
Unehanged-sinca  returns  a  list  of  the  nodes  whose  last  transition  occurred  prior  to  the  argu¬ 
ment  tint. 

The  prog  special  form  is  used  to  define  local  symbols.  After  the  symbol  ptag  comes  a  list 
of  symbols  that  are  to  be  made  local  and  following  that  list  is  a  sequence  of  expressions. 
When  a  prog  is  evaluated  the  old  values  of  the  symbols  in  the  list  are  saved,  their  current 
values  are  set  to  nil,  and  the  sequence  of  expressions  is  evaluated.  When  the  evaluation  is 
done  the  old  values  of  the  local  variables  are  restored  and  the  result  of  the  evaluation  of  the 
last  expression  in  the  sequence  is  returned  as  the  value  of  the  prog.  In  this  ease,  the  only 
local  symbol  is  ue^tist  and  the  value  of  the  preg  will  be  the  result  of  evaluating  the  walk-net 
function. 

The  walk-net  function  takes  as  its  argument  a  function  definition  or  a  symbol  that  has  a 
function  definition.  Walk-net  then  traverses  the  circuit  and  for  each  node  it  passes  that  node 
to  the  function  and  evaluates  it.  The  value  returned  by  walk-net  is  the  value  returned  by  the 
function  the  last  time  it  was  called. 

In  the  example  we  didn’t  want  to  bother  with  giving  a  symbol  a  function  definition,  so 
we  used  the  lambda  special  form  to  define  an  'anonymous*  function  definition.  This 
anonymous  function  will  build  a  list  of  nodes  that  have  not  been  recently  changed  and  keep  it 
as  the  value  of  uc-list. 

The  predicate  of  the  first  clause  of  the  cond  beginning  on  line  4  tests  (using  the  < 
predicate)  whether  the  most  recent  node  transition  time  of  the  parameter  n  was  before  the 
threshold  time.  If  so,  then  it  sets  the  value  of  ue-llst  to  be  the  list  consisting  of  n  as  the  first 
element  followed  by  the  the  list  that  was  the  previous  value  of  uc4ist.  This  is  done  by  the 
cons  function.  Note  that  this  returns  the  list  as  its  value.  If  the  node  has  been  recently 
changed  then  tie  'default*  clause  (line  6)  of  the  cond  is  executed,  returning  the  unchanged 
value  of  uw-llst.  The  function  defined  by  the  lambda  thus  always  returns  the  current  list. 
Walk-net  therefore  will  return  the  final  value  of  the  list  and  therefore  so  will  the  prog  and 
therefore  so  will  oachangod-dneo. 

f.l.  Samaury 

We  hope  that  by  presenting  these  examples  in  detail  that  we  have  made  a  little  less 
imposing  the  prospect  of  writing  your  own  Lisp  functions  u  pact  of  your  RNL  simulation. 
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based  on  the  FET  model  of  Shichman  and  Hodges.  Three  MOSFET  models  are  implemented; 
MOSl  is  described  by  a  square-law  I-V  characteristic  MOS2  is  an  analytical  model  while  MOS3 
is  a  semi-empirical  model.  Both  MOS2  and  MOS3  include  second-order  effects  such  u 
channel  length  modulation,  subthreshold  conduction,  scattering  limited  velocity  saturation, 
small  size  effects  and  charge-controlled  capacitances. 

1.  TYPES  OF  ANALYSIS 

1.1.  DCAulysb 

The  dc  analysis  portion  of  SPICE  determines  the  dc  operating  point  of  the  circuit  with 
inductors  shorted  and  capacitors  opened.  A  dc  analysis  is  automatically  performed  prior 
to  a  transient  analysis  to  determine  the  transient  initial  conditions,  and  prior  to  an  ac  small- 
signal  analysis  to  determine  the  linearized,  small-signal  models  for  nonlinear  devices.  If 
requested,  the  dc  small-signal  value  of  a  transfer  function  (ratio  of  output  variable  to  input 
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source),  input  resistance,  and  output  resistance  will  also  be  computed  as  a  part  of  the  dc  solu¬ 
tion.  The  dc  analysis  can  also  be  used  to  generate  dc  transfer  curves:  a  specified  indepen¬ 
dent  voltage  or  current  source  is  stepped  over  a  user-specified  range  and  the  dc  output  vari¬ 
ables  are  stored  for  each  sequential  source  value.  If  requested,  SPICE  also  will  determine 
the  dc  small-signal  sensitivities  of  q>ecified  output  variables  with  respect  to  circuit  parameten. 
The  dc  analysis  options  are  specified  on  the  JX^,  .TF,  .OP,  and  SENS  control  cards. 

If  one  desires  to  see  the  small  signal  models  for  nonlinear  devices  in  conjunction  with  a 
transient  analysis  operating  point,  then  the  .OP  card  must  be  provided.  The  dc  bias  conditions 
will  be  identical  for  each  case,  but  the  more  comprehensive  operating  point  information  is 
not  available  to  be  printed  when  transient  initial  conditions  are  computed. 

1 J.  AC  Small-Sigiial  Analysis 

The  ac  small-signal  portion  of  SPICE  computes  the  ac  output  variables  as  a  function  of 
frequency.  The  program  first  computes  the  dc  operating  point  of  the  circuit  and  determines 
linearized,  small-signal  models  for  all  of  the  nonlinear  devices  in  the  circuit.  The  resultant 
linear  circuit  is  then  analyzed  over  a  user-specified  range  of  frequencies.  The  desired  out¬ 
put  of  an  ac  small-  signal  analysis  is  usually  a  transfer  function  (voltage  gain,  transim¬ 
pedance,  etc).  If  the  circuit  hu  only  one  ac  input,  it  is  convenient  to  set  that  input  to 
unity  and  zero  phase,  so  that  output  variables  have  the  same  value  as  the  transfer  func¬ 
tion  of  the  output  variable  with  respect  to  the  input. 

The  generation  of  white  noise  by  resistors  and  semieonductor  deviees  can  also  be  simu¬ 
lated  with  the  ac  small-signal  portion  of  SPICE.  Equivalent  noise  source  values  are  deter¬ 
mined  automatically  from  the  small-signal  operating  point  of  the  circuit,  and  the  contribu¬ 
tion  of  each  noise  source  is  added  at  a  given  summing  point.  The  total  output  noise  level 
and  the  equivalent  input  noise  level  are  determined  at  eaeh  frequency  point.  The  output  and 
input  noise  levels  are  normalized  with  respect  to  the  square  root  of  the  noise  bandwidth  and 
have  the  units  Volts/it  Hz  or  Amps/rt  Hz.  The  output  noise  and  equivalent  input  noise 
can  be  printed  or  plotted  in  the  same  fashion  as  other  output  variables.  No  additional  input 
data  are  necessary  for  this  analysis. 

Flicker  noise  sources  can  be  simulated  in  the  noise  analysis  by  including  values  for  the 
parameters  KF  and  AF  on  the  appropriate  device  model  cards. 

The  distortion  characteristics  of  a  circuit  in  the  small  signal  mode  can  be  simulated 
as  a  part  of  the  ac  small-signal  analysis.  The  analysis  is  performed  assuming  that  one  or 
two  signal  frequencies  are  imposed  at  the  input. 

The  frequency  range  and  the  noise  and  distortion  analysis  parameters  are  specified 
on  the  AC,  J40ISE,  and  J}ISTO  control  lines. 

U.  Traaatcat  Analysb 

The  transient  analysis  portion  of  SPICE  computes  the  transient  output  variables  as  a 
function  of  time  over  a  user  specified  time  interval.  The  initial  conditions  are  automati¬ 
cally  determined  by  a  dc  analysis.  All  souices  which  are  not  time  dependent  (for  example, 
power  supplies)  are  set  to  their  dc  value.  For  large-signal  sinusoidal  simulations,  a 
Fourier  analysis  of  the  output  waveform  can  be  q>ecified  to  obtain  the  frequency  domain 
Fourier  coefficients.  The  transient  time  interval  and  the  Fourier  analysis  options  are  specified 
on  the  .TRAN  and  COURIER  control  lines. 

1.4.  Analysis  at  Different  Temperatures 

All  input  data  for  SPICE  is  assumed  to  have  been  measured  at  27  deg  C  (300  deg  K). 
The  simulation  also  assumes  a  nominal  temperature  of  27  deg  C.  The  circuit  can  be  simulated 
at  other  temperatures  by  using  a  .TEMP  control  line. 

Temperature  appears  explicitly  in  the  exponential  terms  of  the  BJT  and  diode  model 
equations.  In  addition,  saturation  currents  have  a  built-in  temperature  dependence.  The 
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temperature  dependence  of  the  saturation  current  in  the  BJT  models  is  determined  by: 
IS(T1)=IS(T0)[(^)XTIc 

where  k  is  Boltzmann’s  constant,  q  is  the  electronic  charge,  EG  is  the  energy  gap  which 
is  a  model  parameter,  and  XTI  is  the  saturation  current  temperature  exponent  (also  a  model 
parameter,  and  usually  equal  to  3).  The  temperature  dependence  of  forward  and  reverse 
beta  is  according  to  the  formula: 

beta  (T 1 )  =beta  (TO  )  [  1 

where  T1  and  TO  are  in  degrees  Kelvin,  and  XTB  is  a  user-supplied  model  parameter.  Tem¬ 
perature  effects  on  beta  are  carried  out  by  appropriate  adjustment  to  the  values  of  BF,  ISE, 
BR,  and  ISC.  Temperature  dependence  of  the  saturation  current  in  the  junction  diode 
model  is  determined  by: 

IS(T1)=IS(T0)[(^^^^> 

where  N  is  the  emission  coefficient,  which  is  a  model  parameter,  and  the  other  symbols  have 
the  same  meaning  as  above.  Note  that  for  Schottky  barrier  diodes,  the  value  of  the  saturation 
current  temperature  exponent,  XTI,  is  usually  2. 

Temperature  appears  explicitly  in  the  value  of  junction  potential,  PHI,  for  all  the 
device  models.  The  temperature  dependence  is  determined  by: 

PHICTEMP)* 

where  k  is  Boltzmann’s  constant,  q  is  the  electronic  charge,  Na  is  the  acceptor  impurity 
density,  Nd  is  the  donor  impurity  den  sity,  Ni  is  the  intrinsic  concentration,  and  EG  is  the 
energy  gap. 

Temperature  appears  explicitly  in  the  value  of  surface  mobility,  UO,  for  the  MOS- 
FET  model.  The  temperature  dependence  is  determined  by: 

00(TEMP).^^Ug^5^ 

The  effects  of  temperature  on  resistors  is  modeled  by  the  formula: 

value  (TEMP  )»  value  (TNOM  )( 1  +  TC I  (TEMP  -  TNOM  )  + TC  2  [(  TEMP  -  TNOM  )2 1 

where  TEMP  is  the  circuit  temperature,  TNOM  is  the  nominal  temperature,  and  TCI  and 
TC2  are  the  first-  and  second -order  temperature  coefficients. 

2.  CONVERGENCE 

Both  dc  and  transient  solutions  are  obtained  by  an  iterative  process  which  is  terminated 
when  both  of  the  following  conditions  hold: 

1)  The  nonlinear  branch  currents  converge  to  within  a  tolerance  of  0.1  percent  or  1 
picoamp  (IjOE-12  Amp),  whichever  is  larger. 

2)  The  node  voltages  converge  to  within  a  tolerance  of  0.1  per  cent  or  1  microvolt  (1jOE-6 
Volt),  whichever  is  larger. 

Although  the  algorithm  used  in  SPICE  has  been  found  to  be  very  reliable,  in  some 
cases  it  will  fail  to  converge  to  a  solution.  When  this  failure  occurs,  the  program  will  print 
the  node  voltages  at  the  last  iteration  and  terminate  the  job.  In  such  cases,  the  node  vol¬ 
tages  that  are  printed  are  not  necessarily  correct  or  even  close  to  the  correct  solution. 

Failure  to  converge  in  the  dc  analysis  is  usually  due  to  an  error  in  q)ecifying  circuit  con¬ 
nections,  element  values,  or  model  parameter  values.  Regenerative  switching  circuits  or  cir¬ 
cuits  with  positive  feedback  probably  will  not  converge  in  the  dc  analysis  unless  the  OFF 
option  is  used  for  some  of  the  devices  in  the  feedback  path,  or  the  .NODESET  card  is  used  to 
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force  the  circuit  to  converge  to  the  desired  state. 

3.  INPUT  FORMAT 

The  input  format  for  SPICE  is  of  the  free  format  type.  Fields  on  a  card  are 
separated  by  one  or  more  blanks,  a  comma,  an  equal  (=)  sign,  or  a  left  or  right  parenthesis; 
extra  spaces  are  ignored.  A  card  may  be  continued  by  entering  a  -t-  (plus)  in  column  1  of 
the  following  card;  SPICE  continues  reading  beginning  with  column  2. 

A  name  field  must  begin  with  a  letter  (A  through  Z)  and  cannot  contain  any  delim¬ 
iters.  Only  the  first  eight  characters  of  the  name  are  used. 

A  number  field  may  be  an  integer  field  (12,  -44),  a  floating  point  field  (3.141S9),  either  an 
integer  or  floating  point  number  followed  by  an  integer  exponent  (lE-14,  2.6SE3),  or  either 
an  integer  or  a  floating  point  number  followed  by  one  of  the  following  scale  factors: 

T=1E12  G=1E9  MEG=1E6  K=1E3  MIL=2S.4E-6  M»lE-3  U»lE-6  N=lE-9 

P=1E-12  F=1E-15 

Letters  immediately  following  a  number  that  are  not  scale  factors  are  ignored,  and 
letters  immediately  following  a  scale  factor  are  ignored.  Hence,  10,  lOV,  lOVOLTS,  and 
lOHZ  all  represent  the  same  number,  and  M,  MA,  MSEC,  and  MMHOS  all  represent  the 
same  scale  factor.  Note  that  1000,  lOOOD,  lOOOHZ,  1E3,  li)E3,  IICHZ,  and  IK  all  represent 
the  same  number. 

4.  CIRCUIT  DESCRIPTION 

The  circuit  to  be  analyzed  is  described  to  SPICE  by  a  set  of  element  cards,  which 
define  the  circuit  topology  and  element  values,  and  a  set  of  control  cards,  which  define  the 
model  parameters  and  the  run  controls.  The  first  card  in  the  input  deck  must  be  a  title 
card,  and  the  last  card  must  be  a  JEND  card.  The  order  of  the  remaining  cards  is  arbitrary 
(except,  of  course,  that  continuation  cards  must  immediately  follow  the  card  being  contin¬ 
ued). 

Each  element  in  the  circuit  is  specified  by  an  element  card  that  contains  the  element 
name,  the  circuit  nodes  to  which  the  element  is  connected,  and  the  values  of  the  parame¬ 
ters  that  determine  the  electrical  characteristics  of  the  element.  The  first  letter  of  the  ele¬ 
ment  name  specifies  the  element  type.  The  format  for  the  SPICE  element  types  is  given  in 
what  follows.  The  strings  XXXXXXX,  YYYYYYY,  and  ZZZZZZZ  denote  arbitrary 
alphanumeric  strings.  For  example,  a  resistor  name  must  begin  with  the  letter  R  and  can 
contain  from  one  to  eight  characters.  Hence,  R,  Rl,  RSE,  ROUT,  and  R3AC2ZY  are  valid 
resistor  names. 

Data  fields  that  are  enclosed  in  It  and  gt  signs  ’<  >  ’  are  optional.  All  indicated  punc¬ 
tuation  (parentheses,  equal  signs,  etc.)  are  required.  With  respect  to  branch  voltages 
and  currents,  SPICE  uniformly  uses  the  associate  reference  convention  (current  flows  in  the 
direction  of  voltage  drop). 

Nodes  must  be  nonnegative  integers  but  need  not  be  numbered  sequentially.  The 
datum  (ground)  node  must  be  numbered  zero.  The  circuit  cannot  contain  a  loop  of  vol¬ 
tage  sources  and/or  inductors  and  cannot  contain  a  cutset  of  current  sources  and/or  capaci¬ 
tors.  Each  node  in  the  circuit  must  have  a  dc  path  to  ground.  Every  node  must  have  at 
least  two  connections  except  for  transmission  line  nodes  (to  permit  unterminated  transmis¬ 
sion  lines)  and  MOSFET  substrate  nodes  (which  have  two  internal  connections  anyway). 

5.  TITLE  CARD,  COMMENT  CARDS  AND  ,END  CARD 
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5.1.  Title  Card 
Examples: 

POWER  AMPLIFIER  CIRCUIT 
TEST  OF  CAM  CELL 

This  card  must  be  the  first  card  in  the  input  deck.  Its  contents  are  printed  verbatim 
as  the  heading  for  each  section  of  output. 

5J.  .END  Card 

Examples: 

.END 

This  card  must  always  be  the  last  card  in  the  input  deck.  Note  that  the  period  is  an 
integral  part  of  the  name. 

5J.  Comment  Card 

General  Form: 

•  <  any  eoniment> 

Eaamplca: 

•  RF=1K  GAIN  SHOULD  BE  100 

•  MAY  THE  FORCE  BE  WITH  MY  CIRCUfT 

The  asterisk  in  the  fint  column  indicates  that  this  card  is  a  comment  card.  Comment 
cards  may  be  placed  anywhere  in  the  circuit  description. 

6.  ELEMENT  CARDS 

6.1.  Restators 
General  form: 

RXXXXXXX  N1  N2  VALUE  <  TC=TC1<  ,TC2>  > 

Eaamplcs: 

R1  1  2  100 

RCl  12  17  IK  TC=0.001, 0.015 

N1  and  N2  are  the  two  element  nodes.  VALUE  is  the  resistance  (in  ohms)  and  may 
be  positive  or  negative  but  not  zero.  TCI  and  TC2  are  the  (optional)  temperature 
coefficients;  if  not  specified,  zero  is  assumed  for  both.  The  value  of  the  resistor  as  a  func¬ 
tion  of  temperature  is  given  by; 

value  (TEMP  )  =  value  (TNOM )  [  1  +  TC 1  (  TEMP  -  TNOM )  +  TC  2  [  ( TEMP  -  TNOM  )2 ) 
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Capnclton  and  Inductors 
Gencrui  form: 

CXXXXXXX  N-t-  N-  VALUE  <  IC»=lNCOND> 

LYYYYYYY  N+  N-  VALUE  <  IC»lNCOND> 

Ezunples: 

CBYP  13  0  lUF 
COSC  17  23  lOU  IC=3V 
LLINK  42  <9  lUB 
LSHUNT  23  SI  lOU  IC»15.7MA 

N+  tnd  N*  are  the  positive  and  negative  element  nodes,  respectively.  VALUE  is 
the  capacitance  in  Farads  or  the  inductance  in  Henries. 

For  the  capacitor,  the  (optional)  initial  condition  is  the  initial  (time-zero)  value  of 
capacitor  voltage  (in  Volts).  For  the  inductor,  the  (optional)  initial  condition  is  the  initial 
(time-zero)  value  of  inductor  current  (in  Amps)  that  flows  from  N-t-,  through  the  inductor, 
to  N-.  Note  that  the  initial  conditions  (if  any)  apply  ’only’  if  the  UIC  option  is  specified  on 
the  .TRAN  card. 

Nonlinear  capacitors  and  inductors  can  be  described. 

General  form  : 

CXXXXXXX  N+  N-  POLY  CO  Cl  C2  ...  <  lC*INCOND> 

LYYYYYYY  N+  N-  POLY  LO  LI  L2  ...  <lC=INCOND> 

CO  Cl  C2  ..Xaati  LO  LI  L2  ...)  are  the  coefficients  of  a  polynomial  describing  the  element 
value.  The  capacitance  is  expressed  as  a  function  of  the  voltage  across  the  element  while 
the  inductance  is  a  function  of  the  current  through  the  inductor.  The  value  is  computed  as 

value  «  C  0  +  C 1 V  +  C  2-  V2  + ... 

value  =  LO  +  L  M  +  L  2-1^  + ... 

where  V  is  the  voltage  across  the  capacitor  and  I  the  current  flowing  in  the  inductor. 

4.3.  Coupled  (Mutual)  Inductors 
General  form: 

KXXXXXXX  LYYYYYYY  LZZZZZZZ  VALUE 
Examples: 

K43  LAA  LBB  0.999 
KXFRMR  LI  L2  0  J7 

LYYYYYYY  and  LZZZZZZZ  are  the  names  of  the  two  coupled  inductors,  and 
VALUE  is  the  coefficient  of  coupling,  K,  which  must  be  greater  than  0  and  leas  than  or 
equal  to  1.  Using  the  ’dot’  convention,  place  a  ’dot’  on  the  first  node  of  each  inductor. 
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6.4.  TruumlidoB  Llact  (Lonlea) 

General  form: 

TXXXXXXX  N1  N2  N3  N4  Z0=VALUE  <  TDsVALI;E>  <  F-FREQ  <  NL-NRMLEN>  > 
+  <IC-V141,V2JU> 

Ezamplee: 

T1  1  0  2  0  Z0»50  TD===10NS 


N1  and  N2  are  the  nodes  at  port  1;  N3  and  N4  are  the  nodes  at  port  2.  ZO  is  the 
characteristic  impedance.  The  length  of  the  line  may  be  expressed  in  either  of  two  forms. 
The  transmission  delay,  TD,  may  be  specified  directly  (as  TD^lOns,  for  example).  Alterna¬ 
tively,  a  frequency  F  may  be  given,  together  with  NL,  the  normalized  electrical  length  of 
the  transmission  line  nrith  respect  to  the  wavelength  in  the  line  at  the  frequency  F.  If  a 
frequency  is  specified  but  NL  is  omitted,  02S  is  assumed  (that  is,  the  frequency  is  assumed  to 
be  the  quarter-wave  frequency).  Note  that  although  both  forms  for  expressing  the  line 
length  are  indicated  as  optional,  one  of  the  two  must  be  q>eci  fied. 

Note  that  this  element  models  only  one  propagating  mode.  If  all  four  nodes  ate  distinct 
in  the  actual  circuit,  then  two  modes  may  be  excited.  To  simulate  such  a  situation,  two 
transmission  line  elements  are  required,  (see  the  example  in  Appendix  A  for  further 
clarification.) 

The  (optional)  initial  condition  specification  consists  of  the  voltage  and  current  at 
each  of  the  transmission  line  ports.  Note  that  the  initial  conditions  (if  any)  apply  ’only’  if  the 
UIC  option  is  specified  on  the  .TRAN  card. 

One  should  be  aware  that  SPICE  will  use  a  transient  time  step  which  does  not 
exceed  1/2  the  minimum  transmission  line  delay.  Therefore  very  short  transmission  lines 
(compared  with  the  analjrsis  time  frame)  will  cause  long  run  times. 

6S.  Linear  Dependent  Sonrees 

SPICE  allows  circuits  to  contain  linear  dependent  sources  characterized  by  any  of  the 
four  equations 

i=g^  v=e-v  i=f-i  v=hi 

where  g,  e,  f,  and  h  are  constants  representing  transconductance,  voltage  gain,  current  gain, 
and  transresistance,  respectively.  Note:  a  more  complete  description  of  dependent  sources  as 
imple  mented  in  SPICE  is  given  in  Appendix  B. 

6.6.  Linear  Voltage-Controlled  Cnrrent  Sonrees 

General  fonn: 

GXXXXXXX  N+  N-  NC+  NC-  VALUE 
Examples: 

G1  2  0  5  0  O.IMMHO 

N+  and  N-  are  the  positive  and  negative  nodes,  respectively.  Current  flow  is  from  the 
positive  node,  through  the  source,  to  the  negative  node.  NC+  and  NC-  are  the  positive  and 
negative  controlling  nodes,  respectively.  VALUE  is  the  transconductance  (in  mhos). 
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6.7.  Linear  VoItagc^ntroUcd  Voltage  Sonrcea 
General  fomi: 

EXXXXXXX  N+  N-  NC-t-  NC-  VALUE 
Examples: 

El  2  3  14 1  2J) 

N-t-  is  the  positive  node,  and  N*  is  the  negative  node.  NC-I-  and  NC-  are  the  positive 
and  negative  controlling  nodes,  respectively.  VALUE  is  the  voltage  gain. 

4J.  Linear  Cnrrent-Controlled  Cnrrent  Soorees 

General  form: 

FXXXXXXX  N-t-  N-  VNAM  VALUE 
Examples: 

FI  13  5  VSENS  5 

N-f  and  N-  are  the  positive  and  negative  nodes,  respectively.  Current  flow  is  from  the 
positive  node,  through  the  source,  to  the  negative  node.  VNAM  is  the  name  of  a  voltage 
source  through  which  the  controlling  current  flows.  The  direction  of  positive  controlling 
current  flow  is  from  the  positive  node,  throu^  the  source,  to  the  negative  node  of  VNAM. 
VALUE  is  the  current  gain. 

f.9.  Linear  Cnrrent-Controlled  Voltage  Sources 

General  form: 

BXXXXXXX  N-t-  N-  VNAM  VALUE 
Examples: 

HX  5  17  VZ  9SK 

N-t-  and  N-  are  the  positive  and  negative  nodes,  respectively.  VNAM  is  the  name  of  a 
voltage  source  through  which  the  controlling  current  flows.  The  direction  of  positive  con¬ 
trolling  current  flow  is  from  the  positive  node,  through  the  source,  to  the  negative  node  of 
VNAM.  VALUE  is  the  transresistance  (in  ohms). 

4.10.  Independent  Soorees 

General  form: 

VXXXXXXX  N-t-  N-  <  <  DC>  DC/TRAN  VALUE>  <  AC  <  ACMAG  <  ACPHASE>  >  > 
lYYYYYYYN-t- N- <<DC>  DC/TRAN  VALUE>  <  AC  <  ACMAG  <  ACPHASE>  >  > 

Examples: 

VCC  10  0  DC  6 


UW/NW  VLSI  Release  2.1 


-8- 


10/1/83 


UW/NW  VLSI  Consortium 


SPICE  User's  Guide 


VIN  13  2  0.001  AC  1  S1N(0  1  IMEG) 

ISRC  23  21  AC  0  J33  45.0  SFFM(0  1  lOK  5  IK) 

VMEAS  Uf 

N4-  and  N-  are  the  positive  and  negative  nodes,  respectively.  Note  that  voltage  sources 
need  not  be  grounded.  Positive  current  is  assumed  to  flow  from  the  positive  node,  through 
the  source,  to  the  negative  node.  A  current  source  of  positive  value,  will  force  current  to 
flow  out  of  the  N-t-  node,  through  the  source,  and  into  the  N-  node.  Voltage  sources,  in  addi¬ 
tion  to  being  used  for  circuit  excitation,  are  the  ’ammeters'  for  SPICE,  that  is,  zero  valued 
voltage  sources  may  be  inserted  into  the  circuit  for  the  purpose  of  measuring  current.  They 
will,  of  course,  have  no  effect  on  circuit  operation  since  they  represent  short-circuits. 

DC/TRAN  is  the  dc  and  transient  analysis  value  of  the  source.  If  the  source  value 
is  zero  both  for  dc  and  transient  analyses,  this  value  may  be  omitted.  If  the  source  value  is 
time-invariant  (e.g.,  a  power  supply),  then  the  value  may  optionally  be  preceded  by  the  letters 
DC. 

ACMAG  is  the  ac  magnitude  and  ACPHASE  is  the  ac  phase.  The  source  is  set  to 
this  value  in  the  ac  analysis.  If  ACMAG  is  omitted  following  the  keyword  AC,  a  value  of 
unity  is  assumed.  If  ACPHASE  is  omitted,  a  value  of  zero  is  assumed.  If  the  source  is  not 
an  ac  small-signal  input,  the  keyword  AC  and  the  ac  values  are  omitted. 

Any  independent  source  can  be  assigned  a  time-dependent  value  for  transient 
analysis.  If  a  source  is  assigned  a  time-  dependent  value,  the  time-zero  value  is  used  for  dc 
analysis.  There  are  five  independent  source  functions;  pulse,  exponential,  sinusoidal,  piece- 
wise  linear,  and  single-frequency  FM.  If  parameters  other  than  source  values  are  omitted 
or  set  to  zero,  the  default  values  shown  will  be  assumed.  (TSTEP  is  the  printing  increment 
and  TSTOP  is  the  final  time  (see  the  .TRAN  card  for  explanation)). 

1.  Pulse  PULSE(V1  V2  TD  TR  TF  PW  PER) 

Examples: 


VIN  3  0  PULSE(-1  1  2NS  2NS  2NS  SONS  ICONS) 


parameter 

default 

units 

VI  (initial  value) 

Volts  or  Amps 

V2  (pulsed  value) 

Volts  or  Amps 

TD  (delay  time) 

OjO 

seconds 

TR  (rise  time) 

TSTEP 

seconds 

TF  (fall  time) 

TSTEP 

seconds 

PW  (pulse  width) 

TSTOP 

seconds 

PER(period) 

TSTOP 

seconds 

A  single  pulse  so  specified  is  described  by  the  following  table: 
value 


0  VI 
TD  VI 
TD+TR  V2 
TD+TR+PW  V2 
TD+TR+PW+TF  VI 
TSTOP  VI 
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Intermediate  points  are  determined  by  linear  interpolation. 


2.  Sinusoidal  SIN(VO  VA  FREQ  TD  THETA) 
Examples: 


VIN  3  0 

SIN(0  1  lOOMEG  INS 

;  lElO) 

parameter 

default  value 

units 

VO 

(offset) 

Volts  or  Amps 

VA 

(amplitude) 

Volts  or  Amps 

FREQ 

(frequency) 

1/TSTOP 

TD 

(delay) 

0.0 

THETA 

(damping  factor) 

0.0 

The  shape  of  the  waveform  is  described  by  the  following  table: 
time  value 


0  to  TD  VO 

TD  toTSTOP  V0  +  VAe(“(““«~TD)®)sin(2wFREQ(time  +  TD)) 


3.  Exponential  EXP(V1  V2  TDl  TAUl  TD2  TAU2) 
Examples: 


VIN  3  0  EXP(-4  -1  2NS  30NS  60NS  40NS) 
parameters  default  values  units 


VI 

V2 

TDl 

TAUl 

TD2 

TAU2 


(initial  value) 
pulsed  value) 

(rise  delay  time) 
(rise  time  constant) 
(fall  delay  time) 
(fall  time  constant) 


Volts  or  Amps 
Volts  or  Amps 
OD 

TSTEP 

TDl+TSTEP 

TSTEP 


The  shape  of  the  waveform  is  described  by  the  following  table: 
time  value 


Oto  TDl 
TDl  to  TD2 
TD2  toTSTOP  VI 


V 1  +  (V2  -V  1)(1  -e^  -TD1)/TAU1)| 

+  (V 2 -V 1 ) ( 1  - e'  ^ ) /TAU l)  +  (Vl-V2)[l-e(~ 


4.  Piece-Wise  Linear  PWL(T1  VI  <  T2  V2  T3  V3  T4  V4  .„> ) 
Example: 
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VCLOCK  7  5  PWL(0  -7  IONS  -7  IINS  -3  17NS  -3  18NS  *7  SONS  -7) 

Each  pair  of  values  (Ti,  Vi)  specifies  that  the  value  of  the  source  is  Vi  (in  Volts  or 
Amps)  at  time^Tt.  The  value  of  the  source  at  intermediate  values  of  time  is  determined  by 
using  linear  interpolation  on  the  input  values. 


S.  Single-Frequency  FM  SFFM(VO  VA  FC  MDI  FS) 
Examples: 


VI 12  0  SFFM(0  IM  20K  S  IK) 


parameters 

default  values 

units 

VO 

(offset) 

Volts  or  Amps 

VA 

(amplitude) 

Volts  or  Amps 

FC 

(carrier  frequency) 

1/TSTOP 

MDI 

(modulation  index) 

FS 

(signal  frequency) 

1/TSTOP 

The  shape  of  the  waveform  is  described  by  the  following  equation: 
value  +  VO  +  VA  sin  ( (  2  ir  -FC-time )  +  MDI  sin  (  2  ir  -FS-time ) ) 

7.  SEMICONDUCTOR  DEVICES 

The  elements  that  have  been  described  to  this  point  typically  require  only  a  few 
parameter  values  to  specify  completely  the  electrical  characteristics  of  the  element.  How¬ 
ever,  the  models  for  the  four  semiconductor  devices  that  are  included  in  the  SPICE  pro¬ 
gram  require  many  parameter  values.  Moreover,  many  devices  in  a  circuit  often  are  defined 
by  the  same  set  of  device  model  parameters.  For  these  reasons,  a  set  of  device  model 
parameters  is  defined  on  a  separate  AIODEL  card  and  assigned  a  unique  model  name.  The 
device  element  cards  in  SPICE  then  reference  the  model  name.  This  scheme  alleviates  the 
need  to  specify  all  of  the  model  parameters  on  each  device  element  card. 

Each  device  element  card  contains  the  device  name,  the  nodes  to  which  the  device  is 
connected,  and  the  device  model  name.  In  addition,  other  optional  parameters  nuy  be 
specified  for  each  device:  geometric  factors  and  an  initial  condition. 

The  area  factor  used  on  the  diode,  BJT  and  JFET  device  card  determines  the  number 
of  equivalent  parallel  devices  of  a  specified  model.  The  affected  parameters  are  marked  with 
an  asterisk  under  the  heading  'area*  in  the  model  descriptions  below.  Several  geometric 
factors  associated  with  the  channel  and  the  drain  and  source  diffusions  can  be  specified  on 
the  MOSFET  device  card. 

Two  different  forms  of  initial  conditions  may  be  specified  for  devices.  The  first  form 
is  included  to  improve  the  dc  convergence  for  circuits  that  contain  more  than  one  stable 
state.  If  a  device  is  qtecified  OFF,  the  dc  operating  point  is  deter  mined  with  the  terminal 
voltages  for  that  device  set  to  zero.  After  convergence  is  obtained,  the  program  continues 
to  iterate  to  obtain  the  exact  value  for  the  terminal  voltages.  If  a  circuit  has  more  than 
one  dc  stable  state,  the  OFF  option  can  be  used  to  force  the  solution  to  correspond  to  a 
desired  state.  If  a  device  is  specified  OFF  when  in  reality  the  device  is  conducting,  the  pro¬ 
gram  will  still  obtain  the  correct  solution  (assuming  the  solutions  converge)  but  more  itera¬ 
tions  will  be  required  since  the  program  must  independently  converge  to  two  separate  solu¬ 
tions.  The  .NODESET  card  serves  a  similar  purpose  as  the  OFF  option.  The  J40DESET 
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option  is  easier  to  apply  and  is  the  preferred  means  to  aid  convergence. 

The  second  form  of  initial  conditions  are  specified  for  use  with  the  transient  analysis. 
These  are  true  ’initial  conditions’  as  opposed  to  the  convergence  aids  above.  See  the  descrip¬ 
tion  of  the  1C  card  and  the  .TRAN  card  for  a  detailed  explanation  of  initial  conditions. 

7.1.  Juactioa  Diodes 

General  fomi: 

DXXXXXXX  N-t-  N-  MNAME  <  AREA>  <OFF>  <1C=VD> 

Exanplee: 

DBRIOGE  2  10  DIODEl 
OCLMP  3  7  DMOD  3.0  IC=0J 

N-t-  and  N-  are  the  positive  and  negative  nodes,  respectively.  MNAME  is  the  model 
name,  AREA  is  the  area  factor,  and  off  indicates  an  (optional)  starting  condition  on  the 
device  for  dc  analysis.  If  the  area  factor  is  omitted,  a  value  of  ID  is  assumed.  The 
(optional)  initial  condition  specification  using  IC==VD  is  intended  for  use  with  the  UIC 
option  on  the  .TRAN  card,  when  a  transient  analysis  is  desired  starting  from  other  than  the 
quiescent  operating  point. 

7J.  Bipolar  lunctloa  Tranalatort  (BJT’s) 


General  form: 

QXXXXXXX  NC  NB  NE  <NS>  MNAME  <  AREA>  <OFF>  <IC»VBE,VCE> 

Examples: 

Q23  10  24  U  QMOD  IC=0.<4.0 

QSOA  11  2«  4  20  MODI 

NC,  NB,  and  NE  are  the  collector,  base,  and  emitter  nodes,  respectively.  NS  is  the 
(optional)  substrate  node.  If  unspecified,  ground  is  used.  MNAME  is  the  model  name, 
AREA  is  the  area  factor,  and  OFF  indicates  an  (optional)  initial  condition  on  the  device  for 
the  dc  analysis.  If  the  area  factor  is  omitted,  a  value  of  1.0  is  assumed.  The  (optional) 
initial  condition  specification  using  IC=VBE,VCE  is  intended  for  use  with  the  UIC  option 
on  the  .TRAN  card,  when  a  transient  analysis  is  desired  starting  from  other  than  the  quies¬ 
cent  operating  point.  See  the  JC  card  description  for  a  better  way  to  set  transient  initial 
conditions. 

7J.  JancUon  Field-Effect  Transistors  (JFET’s) 

General  form: 

JXXXXXXX  ND  NG  NS  MNAME  <  AREA>  <OFF>  <IC-VDS,VGS> 


'i 


1 

s 


Examples: 

J1  7  2  3  JMl  OFF 
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ND,  NG,  and  NS  are  the  drain,  gate,  and  source  nodes,  respectively.  MNAME  is 
the  model  name,  AREA  is  the  area  factor,  and  OFF  indicates  an  (optional)  initial  condition 
on  the  device  for  dc  analysis.  If  the  area  factor  is  omitted,  a  value  of  1.0  is  assumed.  The 
(optional)  initial  condition  specification,  using  IC-VDS,VGS  is  intended  for  use  with  the 
UIC  option  on  the  .TRAN  card,  when  a  transient  analysis  is  desired  starting  from  other 
than  the  quiescent  operating  point  (see  the  JC  card  for  a  better  way  to  set  initial  conditions). 

7.4.  MOSFETa 

General  form: 

MXXXXXXX  ND  NG  NS  NB  MNAME  <L=VAL>  <W=VAL>  <AD=VAL> 

<  ASsVAL> 

+  <PD=VAL>  <PS=VAL>  <NRD=VAL>  <NRS=VAL>  <OFF> 

<  IC=VDS,VGS,VBS> 

Examples: 

Ml  24  2  0  20  TYPEl 

M31  2  17  6  10  MODM  L=5U  W=2U 

M31  2  16  6  10  MODM  SU  2U 

Ml  2  9  3  0  MODI  L=10U  W=5U  AD«100P  AS=100P  PD=40U  PS=40U 
Ml  2  9  3  0  MODI  lOU  SU  2P  2P 

ND,  NG,  NS,  and  NB  are  the  drain,  gate,  source,  and  bulk  (substrate)  nodes,  respec* 

tively.  MNAME  is  the  model  name.  L  and  W  are  the  channel  length  and  width,  in  meters. 

AD  and  AS  are  the  areas  of  the  drain  and  source  diffusions,  in  sq>meters.  Note  that  the 
suffix  U  specifies  microns  (1E>6  m)  and  P  sq*microns  (1E>12  sq>m).  If  any  of  L,  W, 
AD,  or  AS  are  not  specified,  default  values  are  used.  The  user  may  specify  the  values  to  be 
used  for  these  default  parameters  on  the  .OPTIONS  card.  The  use  of  defaults  simplifies  input 
deck  preparation,  as  well  as  the  editing  required  if  device  geometries  are  to  be  changed. 
PD  and  PS  are  the  perimeters  of  the  drain  and  source  junctions,  in  meters.  NRD  and 
NRS  designate  the  equivalent  number  of  squares  of  the  drain  and  source  diffusions;  these 
values  multiply  the  sheet  resistance  RSH  specified  on  the  MODEL  card  for  an  accurate 
representation  of  the  parasitic  series  drain  and  source  resistance  of  each  transistor.  PD  and 
PS  default  to  OD  while  NRD  and  NRS  to  1.0.  OFF  indicates  an  (optional)  initial  condition  on 
the  device  for  dc  analysis.  The  (optional)  initial  condition  q>ecification  using 

IC»VDS,VGS,VBS  is  intended  for  use  with  the  UIC  option  on  the  .TRAN  card,  when  a 

transient  analysis  is  desired  starting  from  other  than  the  quiescent  operating  point.  See  the 
JC  card  for  a  better  and  more  convenient  way  to  specify  transient  initial  conditions. 

7J.  MODEL  Card 

General  form: 

MODEL  MNAME  TYPE(PNAME1=PVAL1  PNAME2»PVAL2  ... ) 

Examples: 

MODEL  MODI  NPN  BF»S0  IS»1E-13  VBF^SO 

The  MODEL  card  specifies  a  set  of  model  parameters  that  will  be  used  by  one  or 
more  devices.  MNAME  is  the  model  name,  and  type  is  one  of  the  following  seven  types: 

type  description 


UW/NW  VLSI  Release  2.1 


-13- 


10/1/83 


UW/NW  VLSI  Consortium  SPICE  User's  Guide 

NPN  NPN  BJT  model 

PNP  PNP  BJT  model 

D  diode  model 

NJF  N>chaanel  JFET  model 

PJF  P-channel  JFET  model 

NMOS  N-channel  MOSFET  model 

PMOS  P-channel  MOSFET  model 

Parameter  values  are  defined  by  appending  the  parameter  name,  u  given  below  for 
each  model  type,  followed  by  an  equal  sign  and  the  parameter  value.  Model  parameters 
that  are  not  given  a  value  are  assigned  the  default  values  given  below  for  each  model 
type. 


74.  Diode  Model 

The  dc  characteristics  of  the  diode  are  determined  by  the  parameters  IS  and  N.  An 
ohmic  resistance,  RS,  is  included.  Charge  storage  effects  are  modeled  by  a  transit  time,  TT, 
and  a  nonlinear  depletion  layer  capacitance  which  is  determined  by  the  parameters  CIO,  VJ, 
and  M.  The  temperature  dependence  of  the  saturation  current  is  defined  by  the  parame¬ 
ters  EG,  the  energy  and  XTI,  the  saturation  current  temperature  exponent.  Reverse  break¬ 
down  is  modeled  by  an  exponential  increase  in  the  reverse  diode  current  and  is  determined 
by  the  parameters  BV  and  IBV  (both  of  which  are  positive  numbers). 


name 

parameter 

units 

default 

example 

area 

1 

IS 

saturation  current 

A 

l.OE-14 

l.OE-14 

• 

2 

RS 

ohmic  resistance 

Ohm 

0 

10 

• 

3 

N 

emission  coefficient 

- 

1 

1.0 

4 

TT 

transit-time 

sec 

0 

O.lNs 

5 

ao 

zero-bias  junction  capacitance 

F 

0 

2PF 

• 

6 

VJ 

junction  potential 

V 

1 

03 

7 

M 

grading  coefficient 

- 

03 

03 

8 

EG 

activation  energy 

eV 

1.11 

1.11  Si 
039  Sbd 
037  Ge 

9 

XTI 

saturation-current  temp,  exp 

• 

3.0 

3.0  jn 
2jOSbd 

10 

KF 

flicker  noise  coefficient 

- 

0 

11 

AF 

flicker  noise  exponent 

- 

1 

12 

FC 

coefficient  for  forward-bias 
depletion  capacitance  formula 

• 

03 

13 

BV 

reverse  breakdown  voltage 

V 

infinite 

40D 

14 

IBV 

current  at  breakdown  voltage 

A 

l.OE-3 

7.7.  BJT  Models  (both  NPN  and  PNP) 

The  bipolar  junction  transistor  model  in  SPICE  is  an  adaptation  of  the  integral  charge 
control  model  of  Gummel  and  Poon.  This  modified  Gummel-Poon  model  extends  the  origi¬ 
nal  model  to  include  several  effects  at  high  bias  levels.  The  model  will  automatically  sim¬ 
plify  to  the  simpler  Ebers-Moll  model  when  certain  parameters  are  not  specified.  The 
parameter  names  used  in  the  modified  Gummel-Poon  model  have  been  chosen  to  be  more 
easily  understood  by  the  program  user,  and  to  reflect  better  both  physical  and  circuit  design 
thinking. 

The  dc  model  is  defined  by  the  parameters  IS,  BF,  NF,  ISE,  IKF,  and  NE  which  deter¬ 
mine  the  forward  current  gain  characteristics,  IS,  BR,  NR,  ISC,  IKR,  and  NC  which  deter¬ 
mine  the  reverse  current  gain  characteristics,  and  VAF  and  VAR  which  determine  the 
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output  conductance  for  forward  and  reverse  regions.  Three  ohmic  resistances  RB,  RC,  and 
RE  are  included,  where  RB  can  be  high  current  dependent.  Base  charge  storage  is  modeled 
by  forward  and  reverse  transit  times,  TF  and  TR,  the  forward  transit  time  TF  being  bias 
dependent  if  desired,  and  nonlinear  depletion  layer  eapacitances  which  are  determined  by 
CJE,  VJE,  and  MJE  for  the  B-E  junction  ,  CJC,  VJC,  and  MIC  for  the  B-C  junction  and 
CJS,  VJS,  and  MIS  for  the  C-S  (Collector-Substrate)  junction.  The  temperature  depen¬ 
dence  of  the  saturation  current,  IS,  is  determined  by  the  energy-gap,  EG,  and  the  saturation 
current  temperature  exponent,  XTI.  Additionally  base  current  temperature  dependence  is 
modeled  by  the  beta  temperature  exponent  XTB  in  the  new  model. 

The  BIT  parameters  used  in  the  modified  Gummel-Poon  model  are  listed  below.  The 
parameter  names  used  in  earlier  versions  of  SPICE2  are  still  accepted. 

Modified  Gummel-Poon  BIT  Parameters 


name 

parameter 

units 

default 

example 

area 

1 

IS 

transport  saturation  current 

A 

1J)E'16 

lBE-15 

• 

2 

BF 

ideal  maximum  forward  beta 

- 

100 

100 

3 

NF 

forward  current  emission  coefficient 

- 

IB 

1 

4 

VAF 

forward  Early  voltage 

V 

infinite 

200 

5 

IKF 

comer  for  forward  beta 

high  current  roll-off 

A 

infinite 

OBI 

• 

6 

ISE 

B-E  leakage  saturation  current 

A 

0 

lBE-13 

• 

7 

NE 

B-E  leakage  emission  coefficient 

- 

1.5 

2 

8 

BR 

ideal  maximum  reverse  beta 

- 

1 

0.1 

9 

NR 

reverse  current  emission  coefficient 

- 

1 

1 

10 

VAR 

reverse  Early  voltage 

V 

infinite 

200 

11 

IKR 

comer  for  reverse  beta 

high  current  roll-off 

A 

infinite 

OBI 

• 

12 

ISC 

B-C  leakage  saturation  current 

A 

0 

lBE-13 

• 

13 

NC 

B-C  leakage  emission  coefficient 

- 

2 

13 

14 

RB 

zero  bias  base  resistance 

Ohms 

0 

100 

• 

15 

IRB 

current  where  base  resistance 

falls  halfway  to  its  min  value 

A 

infinite 

0.1 

m 

16 

RBM 

minimum  base  resistance 

at  high  currents 

Ohms 

RB 

10 

0 

17 

RE 

emitter  resistance 

Ohms 

0 

1 

0 

18 

RC 

collector  resistance 

Ohms 

0 

10 

• 

19 

CJE 

B-E  zero-bias  depletion  capacitance 

F 

0 

2PF 

• 

20 

VJE 

B-E  built-in  potential 

V 

0.75 

03 

21 

MJE 

B-E  junction  exponential  factor 

- 

033 

033 

22 

TF 

ideal  forward  transit  time 

sec 

0 

O.lNs 

23 

XTF 

coefficient  for  bias  dependence  of  TF 

- 

0 

24 

VTF 

voltage  describing  VBC 

dependence  of  TF 

V 

infinite 

25 

ITF 

high-current  parameter 

for  effect  on  TF 

A 

0 

• 

26 

PTF 

excess  phase  at  freq  =1.0/(TF-2PI) 

Hz 

deg 

0 

27 

CJC 

B-C  zero-bias  depletion  capacitance 

F 

0 

2PF 

• 

28 

VJC 

B-C  built-in  potential 

V 

0.75 

03 

29 

MIC 

B-C  junction  exponential  factor 

- 

033 

03 

30 

XCJC 

fraction  of  B-C  depletion  capacitance 

connected  to  internal  base  node 

- 

1 

31 

TR 

ideal  reverse  transit  time 

sec 

0 

lONs 

32 

CJS 

zero-bias  collector-substrate 
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capacitance 

F 

0 

2PF 

VJS 

substrate  junction  built-in  potential 

V 

0.75 

MJS 

substrate  junction  exponential  factor 

- 

0 

03 

XTB 

forward  and  reverse  beta 

temperature  exponent 

- 

0 

36 

EG 

energy  gap  for  temperature 

effect  on  IS 

eV 

1.11 

37 

XTI 

temperature  exponent  for  effect  on  B 

- 

3 

38 

KF 

flicker-noise  coefficient 

- 

0 

39 

AF 

flicker-noiae  exponent 

- 

1 

40 

FC 

coefficient  for  forward-bias 

depletion  capacitance  formula 

- 

OS 

7  J.  JFET  Models  (both  N  and  P  Channel) 

The  JFET  model  is  derived  from  the  FET  model  of  Shichman  and  Hodges.  The  dc 
characteristics  are  defined  by  the  parameters  VTO  and  BETA,  which  determine  the  variation 
of  drain  current  with  gate  voltage,  LAMBDA,  which  determines  the  output  conductance, 
and  IS,  the  saturation  current  of  the  two  gate  junctions.  Two  ohmic  resistances,  RD  and 
RS,  are  included.  Charge  storage  is  modeled  by  nonlinear  depletion  layer  capacitances  for 
both  gate  junctions  which  vary  as  the  *1/2  power  of  junction  voltage  and  are  defined  by  the 
parameters  CGS,  CGD,  and  PB. 


name 

parameter 

units 

default 

example 

tret 

1 

VTO 

threshold  voltage 

V 

■2J0 

■2X) 

2 

BETA 

transconductance  parameter 

a/v2 

l.OE-4 

lJOE-3 

• 

3 

LAMBDA 

channel  length  modulation 

parameter 

1/V 

0 

lOE-4 

4 

RD 

drain  ohmic  resistance 

Ohm 

0 

100 

• 

5 

RS 

source  ohmic  resistance 

Ohm 

0 

100 

• 

6 

CGS 

zero-bias  G-S  junction  capacitance 

F 

n 

5PF 

• 

7 

CGD 

zero-bias  G-D  junction  capacitance 

F 

0 

IPF 

• 

8 

PB 

gate  junction  potential 

V 

1 

0j6 

9 

IS 

gate  junction  saturation  current 

A 

l.OE-14 

lOE-14 

• 

10 

KF 

dicker  noise  coefficient 

- 

0 

11 

AF 

flicker  noise  exponent 

- 

1 

12 

FC 

coefficient  for  forward-bias 

• 

03 

depletion  capacitance  formula 


7.9.  MOSFET  Models  (both  N  and  P  channel) 

SPICE  provides  three  MOSFET  device  models  which  differ  in  the  formulation  of 
the  I-V  eharacteristic.  The  variable  LEVEL  specifics  the  model  to  be  used: 

LEVEL^l  •>  Shiehman-Hodges 
LEVEL  »2  •>  MOS2  (as  described  in  [1]) 

LEVEL»3  •>  MOS3,  a  semi-empirical  model(see  (Ij) 

The  dc  characteristics  of  the  MOSFET  are  defined  by  the  device  parameters  VTO, 
KP,  LAMBDA,  PHI  and  GAMMA.  These  parameters  are  computed  by  SPICE  if  process 
parameters  (NSUB,  TOX,  ...)  are  given,  but  user-specified  values  always  override.  VTO  is 
positive  (negative)  for  enhancement  mode  and  negative  (positive)  for  depletion  mode  N- 
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channel  (P-channel)  devices.  Charge  storage  is  modeled  by  three  constant  capacitors,  CGSO, 
CGDO,  and  CGBO  which  represent  overlap  capacitances,  by  the  nonlinear  thin-oxide  capaci¬ 
tance  which  is  distributed  among  the  gate,  source,  drain,  and  bulk  regions,  and  by  the  non¬ 
linear  depletion-layer  capacitances  for  both  substrate  junctions  divided  into  bottom  and  peri¬ 
phery,  which  vary  as  the  MJ  and  MISW  power  of  junction  voltage  respecively,  and  are  deter¬ 
mined  by  the  parameters  CBD,  CBS,  CJ,  CJSW,  MJ,  MJSW  and  PB.  There  are  two  built- 
in  models  of  the  charge  storage  effects  associated  with  the  thin-oxide.  The  default  is  the 
piecewise  linear  voltage-dependent  capacitance  model  proposed  by  Meyer.  The  second  choice 
is  the  charge-controlled  capacitance  model  of  Ward  and  Dutton  [1].  The  XQC  model  param¬ 
eter  acts  as  a  flag  and  a  coefficient  at  the  same  time.  As  the  former  it  causes  the  program  to 
use  Meyer’s  model  whenever  larger  than  03  or  not  specified,  and  the  charge-controlled  model 
when  between  0  and  03.  In  the  latter  case  its  value  defines  the  share  of  the  channel  charge 
associated  with  the  drain  terminal  in  the  saturation  region.  The  thin-oxide  charge  storage 
effects  are  treated  slightly  different  for  the  LEVEL=1  model.  These  voltage-  dependent 
capacitances  are  included  only  if  TOX  is  specified  in  the  input  description  and  they  are 
represented  using  Meyer’s  formulation. 

There  is  some  overlap  among  the  parameters  describing  the  junctions,  e.g.  the  reverse 
current  can  be  input  either  as  IS  (in  A)  or  as  JS  (in  A/m^).  Whereas  the  first  is  an  absolute 
value  the  second  is  multiplied  by  AD  and  AS  to  give  the  reverse  current  of  the  drain  and 
source  junctions  respectively.  This  methodology  has  been  chosen  since  there  is  no  sense  in 
relating  always  junction  characteristics  with  AD  and  AS  entered  on  the  device  card;  the 
areas  can  be  defaulted.  The  same  idea  applies  also  to  the  zero-bias  junction  capacitances 
CBD  and  CBS  (in  F)  on  one  hand,  and  CJ  (in  F/m^)  on  the  other.  The  parasitic  drain  and 
source  series  resistance  can  be  expressed  as  either  RD  and  RS  (in  ohms)  or  RSH  (in 
ohms/sq.),  the  latter  being  multipli^  by  the  number  of  squares  NRD  and  Niis  input  on  the 
device  card. 


name 

parameter 

units 

default 

example 

1 

LEVEL 

model  index 

• 

I 

2 

VTO 

zero-bias  threshold  voltage 

V 

OjO 

1.0 

3 

KP 

transconductance  parameter 

A/V^ 

2J)E-5 

3.1E-5 

4 

GAMMA 

bulk  threshold  parameter 

yO.S 

OB 

037 

5 

PHI 

surface  potential 

V 

03 

03S 

6 

LAMBDA 

channel-length  modulation 

(MOSl  and  MOS2  only) 

1/V 

OB 

0B2 

7 

RD 

drain  ohmic  resistance 

Ohm 

OB 

IB 

8 

RS 

source  ohmic  resistance 

Ohm 

OB 

IB 

9 

CBD 

zero-bias  B-D  junction  capacitance 

F 

OB 

20FF 

10 

CBS 

zero-bias  B-S  junction  capacitance 

F 

OB 

20FF 

11 

IS 

bulk  junction  saturation  current 

A 

l.OE-14 

IBE-IS 

12 

PB 

bulk  junction  potential 

V 

OB 

0B7 

U 

CGSO 

gate-source  overlap  capacitance 

per  meter  channel  width 

F/m 

OB 

4BE-11 

14 

CGDO 

gate-drain  overlap  capacitance 

per  meter  channel  width 

F/m 

OB 

4BE-11 

IS 

CGBO 

gate-bulk  overlap  capacitance 

per  meter  channel  length 

F/m 

OB 

2BE-10 

16 

RSH 

drain  and  source  diffusion 

sheet  resisitance 

Ohm/sq. 

OB 

10.0 

(1]  A.  VUdiiiiiracu  tod  S.  Liu,  *T1ie  Sinulalioa  of  MOS  iDlegrated  Qrcuitt  Utios  SPtCE2*,  ERL  Memo 
No.  ERL  MSOtTflectroiiics  Research  Laboratory.  Uoiversity  of  California,  Berkeley,  Oct.  1980. 


UW/NW  VLSI  Release  2.1 


-  17- 


10/1/83 


UW/NW  VLSI  Consortium 


SPICE  User's  Guide 


17 

CJ 

zero-bias  bulk  junction  bottom  cap. 

per  sq-meter  of  junction  area 

F/m^ 

OD 

2J0E-4 

18 

MJ 

bulk  junction  bottom  grading  eoef. 

- 

03 

03 

19 

CJSW 

zero-bias  bulk  junction  sidewall  cap. 

per  meter  of  junction  perimeter 

F/m 

OJO 

lJOE-9 

20 

MJSW 

bulk  junction  sidewall  grading  coef. 

- 

033 

21 

JS 

bulk  junction  saturation  current 

per  sq-meter  of  junction  area 

A/m^ 

l.OE-8 

22 

TOX 

oxide  thickness 

meter 

l.OE-7 

ljOE-7 

23 

NSUB 

substrate  doping 

l/cmj 

OjO 

4J0E15 

24 

NSS 

surface  state  density 

l/cmj 

OJO 

UOEIO 

25 

NFS 

fast  surface  state  density 

1/cm^ 

OjO 

lilElO 

26 

TPG 

type  of  gate  material: 

- 

1.0 

+1  opp.  to  substrate 

-1  same  as  substrate 

0  Al  gate 

27 

XJ 

metallurgical  junction  depth 

meter 

OD 

lU 

28 

LD 

lateral  diffusion 

meter 

OJ) 

OjBU 

29 

UO 

surface  mobility 

cm^/V  -s 

600 

700 

30 

UCRIT 

critical  field  for  mobility 

degradation  (MOS2  only) 

V/cm 

1.0E4 

1J0E4 

31 

UEXP 

critical  field  exponent  in 

mobility  degradation  (MOS2  only) 

- 

OJ) 

0.1 

32 

UTRA 

transverse  field  coeff  (mobility) 

(deleted  for  MOS2) 

- 

OD 

03 

33 

VMAX 

maximum  drift  velocity  of  carriers 

m/s 

OjO 

5i)E4 

34 

NEFF 

total  channel  charge  (fixed  and 

mobile)  coefficient  (MOS2  only) 

- 

1.0 

5J0 

35 

XQC 

thin-oxide  capacitance  model  flag 

and  coefficient  of  channel  charge 

share  attributed  to  drain  (0-03) 

• 

1.0 

0.4 

36 

KF 

flicker  noise  coefficient 

- 

OD 

1jOE-26 

37 

AF 

flicker  noise  exponent 

- 

1.0 

12 

38 

FC 

coefficient  for  forward-bias 

depletion  capacitance  formula 

03 

39 

DELTA 

width  effect  on  threshold  voltage 

(MOS2  and  MOS3) 

- 

OD 

UO 

40 

THETA 

mobility  modulation  (MOS3  only) 

1/V 

OD 

0.1 

41 

ETA 

static  feedback  (MOS3  only) 

- 

OJO 

UO 

42 

KAPPA 

saturation  field  factor  (MO^  only) 

• 

02 

03 

S. 

SUBCIRCUITS 

A  subcircuit 

that  consists  of  SPICE  elements  can 

be  defined  and 

referenced 

in  a 

fashion  similar  to  device  models.  The  sob-  circuit  is  defined  in  the  input  deck  by  a  grouping 
of  element  cards;  the  program  then  automatically  inserts  the  group  of  elements  wherever 
the  subcircuit  is  referenced.  There  is  no  limit  on  the  size  or  complexity  of  subcircuits, 
and  subcircuits  may  contain  other  subcircuits.  An  example  of  subcircuit  usage  is  given  in 
Appendix  A. 

S.l.  .SUBCKTCard 

General  form: 

^UBCKT  sobnam  N1  <  N2  N3  ...> 
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Examples: 

^UBCKT  OPAMP  12  3  4 

A  circuit  definition  is  begun  with  a  £UBCKT  card.  SUBNAM  is  the  subcircuit  name, 
and  Nl,  N2,  ...  are  the  external  nodes,  which  cannot  be  zero.  The  group  of  element  cards 
which  immediately  follow  the  .SUBCKT  card  define  the  subcircuit.  The  last  card  in  a  sub¬ 
circuit  definition  is  the  .ENDS  card  (see  below).  Control  cards  may  not  appear  within  a 
vsubcircuit  definition;  however,  subcircuit  definitions  may  contain  anything  else,  including 
other  subcircuit  definitions,  device  models,  and  subcircuit  calls  (see  below).  Note  that  any 
device  models  or  subcircuit  definitions  included  as  part  of  a  subcircuit  definition  are  strictly 
local  (i.e.,  such  models  and  definitions  are  not  known  outside  the  subcircuit  definition). 
Also,  any  element  nodes  not  included  on  the  .SUBCKT  card  are  strictly  local,  with  the 
exception  of  0  (ground)  which  is  always  global. 

8.2.  .ENDS  Card 

General  form: 

XNDS  <  SUBNAM> 

Examples: 

J;NDS  OPAMP 

This  card  must  be  the  last  one  for  any  subcircuit  definition.  The  subcircuit  name,  if 
included,  indicates  which  subcircuit  definition  is  being  terminated;  if  omitted,  all  subcircuits 
being  defined  are  terminated.  The  name  is  needed  only  when  nested  subcircuit  definitions 
are  being  made. 

8J.  Sobclrcolt  Calls 

General  form: 

XYYYYYYY  Nl  <  N2  N3  ...>  SUBNAM 
Examples: 

XI  2  4  17  3  1  MULTI 

Subcircuits  are  used  in  SPICE  by  specifying  pseudo-elements  beginning  with  the  letter 
X,  followed  by  the  circuit  nodes  to  be  used  in  expanding  the  subcircuit. 

9.  CONTROL  CARDS 

9.1.  .TEMP  Card 

General  form: 

.TEMP  T1  <  T2  <  T3  ...>  > 

Examples: 

.TEMP  -55.0  25.0  125.0 
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This  card  specifies  the  temperatures  at  which  the  circuit  is  to  be  simulated.  Tl.  T2,  ... 
Are  the  different  temperatures,  in  degrees  C.  Temperatures  less  than  -2231)  deg  C  are 
ignored.  Model  data  are  specified  at  TNOM  degrees  (see  the  .OPTIONS  card  for  TNOM);  if 
the  .TEMP  card  is  omitted,  the  simulation  will  also  be  performed  at  a  temperature  equal  to 
TNOM. 

9J.  .WIDTH  Card 
General  form: 

.WIDTH  IN^COLNUM  OUTsCOLNUM 
Examples: 

.WIDTH  IN-72  OUT«133 

COLNUM  is  the  last  column  read  from  each  line  of  input;  the  setting  takes  effect  with 
the  next  line  read.  The  default  value  for  COLNUM  is  80.  The  out  parameter  q)ecifies  the 
output  print  width.  Permissible  values  for  the  output  print  width  are  80  and  U3. 

93.  .OPTIONS  Card 

General  form: 

.OPTIONS  OPTl  OPT2  ...  (or  OPT-OPTVAL  ...) 

Examples: 

.OPTIONS  ACCT  LIST  NODE 

This  card  allows  the  user  to  reset  program  control  and  user  options  for  specific  simula¬ 
tion  purposes.  Any  combination  of  the  following  options  may  be  included,  in  any  order,  ’x’ 
(below)  represents  some  positive  number. 

option  effect 

ACCT  causes  accounting  and  run  time  statistics  to  be  printed 

LIST  causes  the  summary  listing  of  the  input  data  to  be  printed 

NOMOD  suppresses  the  printout  of  the  model  parameters. 

NOPAGE  suppresses  page  ejects 

NODE  causes  the  printing  of  the  node  table. 

OPTS  causes  the  option  values  to  be  printed. 

GMIN->x  sets  the  value  of  GMIN,  the  minimum  conductance  allowed  by  the  program. 

The  default  value  is  lDE-12. 

RELTOL^  resets  the  relative  error  tolerance  of  the  program.  The  default  value  is 
OjOOI  (0.1  percent). 

ABSTOL»x  resets  the  absolute  current  error  tolerance  of  the  program.  The  default 
value  is  1  pieoamp. 

VNTOL’bx  resets  the  absolute  voltage  error  tolerance  of  the  program.  The  default 
value  is  1  microvolt. 

TRTOL-x  resets  the  transient  error  tolerance.  The  default  value  is  7J).  This  parame¬ 
ter  is  an  estimate  ot  the  factor  by  which  SPICE  overestimates  the  actual 
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PIVTOL=x 

PIVREL-z 


NUMDGT»i 


TNOM-* 

ITLl-x 

ITL2-* 

ITL3=x 

ITL4-* 

ITL5=x 

ITL6-X 

CPTIME  =x 
LIMTIM^x 


LIMPTS^x 

LVLCOD-x 

LVLTIM=x 


METHODsflune 

MAXORD«x 

DEFL-x 

DEFW«x 

DEFAD«x 

DEFAS*x 


truncation  error.  IP  'CHGTOL^x*  17  resets  the  charge  tolerance  of  the 
program.  The  default  value  is  l.OE-14. 

resets  the  absolute  minimum  value  for  a  matrix  entry  to  be  accepted  as  a 
pivot.  The  default  value  is  IJOE-IS. 

resets  the  relative  ratio  between  the  largest  column  entry  and  an  acceptable 
pivot  value.  The  default  value  is  li)E-3.  In  the  numerical  pivoting  algo¬ 
rithm  the  allowed  minimum  pivot  value  is  determined  by 
EPSREL«AMAXl(PIVRELMAXVAL.PIVTOL)  where  MAXVAL  is 
the  maximum  element  in  the  column  where  a  pivot  is  sought  (partial  pivot¬ 
ing). 

is  the  number  of  significant  digits  printed  for  output  variable  values.  X 
must  satisfy  the  relation  0  <  x  <  8.  The  default  value  is  4.  Note:  this 
option  is  independent  of  the  error  tolerance  used  by  SPICE  (ije.,  if  the 
values  of  options  RELTOL,  ABSTOL,  etc.,  are  not  changed  then  one  may 
be  printing  numerical  ‘noise*  for  NUMDGT  >  4. 

resets  the  nominal  temperature.  The  default  value  is  27  deg  C  (300  deg  K). 

resets  the  dc  iteration  limit.  The  default  is  100. 

resets  the  dc  transfer  curve  iteration  limit.  The  default  is  50. 

resets  the  lower  transient  analysis  iteration  limit.  The  default  value  is  4. 

resets  the  transient  analysis  timepoint  iteration  limit.  The  default  is  10. 

resets  the  transient  analysis  total  iteration  limit.  The  default  is  5000.  Set 
rTL5sO  to  omit  this  test. 

resets  the  dc  iteration  limit  at  each  step  of  the  source  stepping  method. 
The  default  is  0  which  means  not  to  use  this  method. 

is  the  maximum  cpu-time  in  seconds  allowed  for  this  job. 

resets  the  amount  of  cpu  time  reserved  by  SPICE  for  generating  plots 
should  a  cpu  time-limit  cause  job  termination.  The  default  value  is  2 
(seconds). 

resets  the  total  number  of  points  that  can  be  printed  or  plotted  in  a  dc,  ac, 
or  transient  analysis.  The  default  value  is  201. 

if  X  is  2  (two),  then  machine  code  for  the  matrix  solution  will  be  generated. 
Otherwise,  no  machine  code  is  generated.  The  default  value  is  2.  Apidies 
only  to  CDC  computers. 

is  1  (one),  the  iteration  timestep  control  is  used,  if  x  is  2  (two),  the 
truncation-error  timestep  is  used.  The  default  value  is  2.  If  method  «Gear 
and  MAXORD>  2  then  LVLTIM  is  set  to  2  by  SPICE. 

sets  the  numerical  integration  method  used  by  SPICE.  Possible  names  are 
Gear  or  trapezoidal.  The  default  is  trapezoidal. 

sets  the  maximum  order  for  the  integration  method  if  Gear’s  variable-order 
method  is  used.  X  must  be  between  2  and  6.  The  default  value  is  2. 

resets  the  value  for  MOS  channd  length;  the  default  is  IOOjO  micrometer, 
resets  the  value  for  MOS  channel  width;  the  default  is  lOOD  micrometer, 
resets  the  value  for  MOS  drain  diffusion  area;  the  default  is  OB. 
resets  the  value  for  MOS  source  diffusion  area;  the  default  is  OB. 
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9.4.  .OP  Cud 
Genual  form: 

.OP 

The  inclusion  of  this  card  in  an  input  deck  will  force  SPICE  to  determine  the  dc  operat¬ 
ing  point  of  the  circuit  with  inductors  shorted  and  cq>aeiton  opened.  Note:  a  dc  analysis  is 
automatically  performed  prior  to  a  transient  analysis  to  determine  the  transient  initial  con¬ 
ditions,  and  prior  to  an  ac  small-signal  analysis  to  determine  the  linearised,  small-signal 
models  for  nonlinear  devices. 

SPICE  performs  a  dc  operating  point  analym  if  no  other  analyses  are  icqueated. 

9.5.  JX^Card 
General  form: 

JJC  SRCNAM  VSTART  VSTOP  VINCR  (SRC2  START2  STOP!  INCR2] 


jn:  vin  •  J5  5.a  o  js 
J>C  VDS  0  M  .5  VGS  0  51 
JIC  VCE  0  10  J5  n  0  lOU  lU 

This  card  defines  the  dc  transfer  curve  source  and  sweep  limits.  SRCNAM  is  the 
name  of  an  independent  voltage  or  current  source.  VSTART,  VSTOP,  and  VINCR  are  the 
starting,  final,  and  incrementing  values  respectively.  The  first  example  will  cause  the  value 
of  the  voltage  source  VIN  to  be  swept  from  0.2S  Volts  to  5.0  Volts  in  increments  of  025 
Volts.  A  second  source  (SRC2)  may  optionally  be  specified  with  associated  sweep  pvameters. 
In  this  case,  the  first  source  will  be  swept  over  its  range  for  each  value  of  the  second  source. 
This  option  can  be  useful  for  obtaining  semiconductor  device  output  characteristics.  See 
the  second  example  data  deck  in  that  section  of  the  guide. 

9.4.  JfODESETCard 

Gcaeral  fum: 

.NODESET  V(NOONUM)-VAL  V(NODNUM)«VAL ... 


JHODESET  V(12)-4J  V(4)»223 

This  card  helps  the  program  find  the  dc  or  initial  transient  solution  by  making  a  prel¬ 
iminary  pam  with  the  q>ecified  nodes  held  to  the  given  voltages.  The  restriction  is  then 
released  and  the  iteration  continues  to  the  true  solution.  The  NODESET  card  may  be  neces¬ 
sary  for  convergence  on  bistable  or  astable  circuits.  In  general,  this  card  should  not  be  neces¬ 
sary. 
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9.7.  JCCard 
GcBcml  form: 

JC  V(NODNUM)«VAL  V(NODNUM)*VAL ... 

Exampleo: 

JC  V(ll)=5  V(4)*-5  V(2)«2J 

This  card  is  for  setting  transient  initial  conditions.  It  has  two  different  interpreta* 
tions,  depending  on  whether  the  UIC  parameter  is  specified  on  the  .TRAN  card.  Also,  one 
should  not  confuse  this  card  with  the  NODESET  card.  The  NODESET  card  is  only  to 
help  dc  convergence,  and  does  not  affect  final  bias  solution  (except  for  multi-stable  circuits). 
The  two  interpretations  of  this  card  are  as  follows: 

1.  When  the  UIC  parameter  is  specified  on  the  .TRAN  card,  then  the  node  voltages 
specified  on  the  JC  card  are  used  to  compute  the  capacitor,  diode,  BJT,  JFET,  and 
MOSFET  initial  conditions.  This  is  equivalent  to  specifying  the  IC=...  parameter  on 
each  device  card,  but  is  much  more  convenient.  The  IC»...  parameter  can  still  be 
specified  and  will  take  precedence  over  the  1C  values.  Since  no  dc  bias  (initial  tran¬ 
sient)  solution  is  conqiuted  before  the  transient  analysis,  one  should  take  care  to 
specify  all  dc  source  voltages  on  the  .IC  card  if  they  are  to  be  used  to  compute  device 
initial  conditions. 

2.  When  the  UIC  parameter  is  not  specified  on  the  .TRAN  card,  the  dc  bias  (initial  tran¬ 
sient)  solution  will  be  computed  before  the  transient  analysis.  In  this  case,  the  node 
voltages  specified  on  the  JC  card  will  be  forced  to  the  desired  initial  values  during  the 
bias  solution.  During  transient  analysis,  the  constraint  on  these  node  voltages  is 
removed. 

9 J.  .TF  Card 

General  form: 

.TF  OUTVAR  INSRC 
Examples: 

.TF  V(5^)  VIN 

.TF  KVLOAO)  VIN 

This  card  defines  the  small  signal  output  and  input  for  the  dc  small  signal  analysis. 
OUTVAR  is  the  small-signal  output  variable  sod  INSRC  is  the  small-signal  input  source.  If 
this  card  is  included,  SPICE  will  compute  the  dc  small  signal  value  of  the  transfer  function 
(output/inpat),  input  resistance,  and  output  resistance.  For  the  first  example,  SPICE  would 
compute  the  ratio  of  V(S,3)  to  VIN,  the  small-signal  input  resistance  at  VIN,  and  the  small- 
signal  output  resistance  measured  across  nodes  S  and  3. 

9.9.  .SENS  Card 

General  form: 

.SENS  OVl  <OV2  ...  > 
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EsaaplMt 

^NS  V(f)  V(43)  V(17)  I(VCC) 

If  ■  ^ENS  cird  is  ineluded  in  the  input  deck,  SPICE  will  determine  the  dc  small* 
signal  sensitivities  of  each  speciSed  output  variable  with  respect  to  every  circuit  parameter. 
Note:  for  large  circuits,  large  amounts  of  output  mm  be  generated. 

f.lO.  JlCCard 

General  form: 

.AC  DEC  ND  FSTART  ESTOP 
JiC  OCT  NO  FSTART  ESTOP 
JiC  UN  NP  FSTART  ESTOP 

Esamples: 

JkC  DEC  10  1  lOK 
JiC  DEC  10  IK  lOOMEG 
JkC  UN  100  1  lOOBZ 

DEC  stands  for  decade  variation,  and  ND  is  the  number  of  points  per  decade.  OCT 
stands  for  octave  variation,  and  NO  is  the  number  of  points  per  octave.  LIN  stands  for 
linear  variation,  and  NP  is  the  number  of  points.  FSTART  is  the  starting  frequency,  and 
FSTOP  is  the  final  frequency.  If  this  card  is  included  in  the  deck,  SPICE  will  perform  an 
ac  analysis  of  the  circuit  over  the  specified  frequency  range.  Note  that  in  order  for  this 
analysis  to  be  meaningful,  at  least  one  independent  source  must  have  been  specified  with  an 
ac  vdue. 

9.11.  JnSTOCard 
General  form: 

JHSTO  RLOAD  <INTER  <SKW2  <REFPWR  <SPW2>>>> 

Esamples: 

JIISTO  RL  2  0.95  1 J)E-3  0.7S 

This  card  controls  whether  SPICE  will  compute  the  distortion  characteristic  of  the  cir¬ 
cuit  in  a  small-signal  mode  as  a  part  of  the  ac  small-signal  sinusoidal  steady-state  analysis. 
The  analysis  is  performed  assuming  that  one  or  two  signal  frequencies  are  imposed  at  the 
input;  let  the  two  frequencies  be  fl  (the  nominal  analysis  frequency)  and  f2 
(  >SKW2-f  1).  The  program  then  computes  the  ftrilowing  distortion  measures: 

HD2  -  the  magnitude  of  the  frequency  component  2'f  1  assuming  that  f2  is  not  present. 

HD3  -  the  magnitude  of  the  frequency  component  3-f  1  assuming  that  f2  is  not  present. 

SIM2  -  the  magnitude  of  the  frequency  component  fl  -f  f2. 

DIM2  -  the  magnitude  of  the  frequency  component  f  1  -  f2. 

DIM3  -  the  magnitude  of  the  frequency  component  2*f  1  -  f2. 

RLOAD  is  the  name  of  the  output  load  resistor  into  which  all  distortion  power  pro¬ 
ducts  are  to  be  computed.  INTER  is  the  interval  at  which  the  summary  printout  of  the 
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contributions  of  all  nonlinear  devices  to  the  total  distortion  is  to  be  printed.  If  omitted  or 
set  to  zero,  no  summary  printout  will  be  made.  REFPWR  is  the  reference  power  level  used 
in  computing  the  distortion  products:  if  omitted,  a  value  of  1  mW  (that  is,  dbm)  is  used. 
SKW2  is  the  ratio  of  f2  to  fl.  If  omitted,  a  value  of  0.9  U  used  (i.e..  f2  =  0.9  f  1).  SPW2  is 
the  amplitude  of  f2.  If  omitted,  a  value  of  li>  is  assumed,  he  distortion  measures  HD2, 
HD3,  SIM2,  DIM2,  and  DIM3  may  also  be  be  printed  and/or  plotted  (see  the  description  of 
the  PRINT  and  PLOT  cards). 

9.U.  PiOISECard 

Gaaaral  form: 

J40ISE  OUTV  INSRC  NUMS 
Ezamplcs: 

J40ISE  V(5)  VIN  10 

This  card  controls  the  noise  analysis  of  the  circuit.  The  noise  analysis  is  performed  in 
conjunction  with  the  ac  analysis  (see  AC  card).  OUTV  is  an  output  voltage  which  defines  the 
summing  point.  INSRC  is  the  name  of  the  independent  voltage  or  current  source  which  is 
the  noise  input  reference.  NUMS  is  the  summary  interval.  SPICE  will  con4>ute  the 
equivalent  output  noise  at  the  qiecified  output  as  well  as  the  equivalent  input  noise  at  the 
specified  input.  In  addition,  the  contributions  of  every  noise  generator  in  the  circuit  will  be 
printed  at  every  NUMS  frequency  points  (the  summary  interval).  If  NUMS  is  zero,  no  sum* 
mary  printout  will  be  made. 

The  output  noise  and  the  equivalent  input  noise  may  also  be  printed  and/or  plotted 
(see  the  description  of  the  PRINT  and  .PLOT  cards). 

9.13.  .TRAN  Card 

General  form: 

.TRANTSTEPTSTOP<TSTART<TMAX>>  <UIC> 

Eiamples: 

.TRAN  INS  ICONS 

.TRAN  INS  lOOONS  500NS 

.TRAN  IONS  lUS  UIC 

TSTEP  is  the  printing  or  plotting  increment  for  line-printer  output.  For  use  with  the 
post-processor,  TSTEP  is  the  suggested  computing  increment.  TSTOP  is  the  final  time,  and 
TSTART  is  the  initial  time.  If  TSTART  is  omitted,  it  is  assumed  to  be  zero.  The  transient 
analysis  always  begins  at  time  zero.  In  the  interval  <zero,  TSTART>,  the  circuit  is 
analyzed  (to  reach  a  steady  state),  but  no  outputs  are  stored.  In  the  interval  <  TSTART, 
TSTOP> ,  the  circuit  is  analyzed  and  outputs  are  stored.  TMAX  is  the  maximum  stepsize 
that  SPICE  will  use  (for  default,  the  program  chooses  either  TSTEP  or  (TSTOP- 
TSTARTySOP,  whichever  is  smaller.  TMAX  is  useful  when  one  wishes  to  guarantee  a  com¬ 
puting  interval  which  is  smaller  than  the  printer  increment,  TSTEP. 

UIC  (use  initial  conditions)  is  an  option^  keyword  which  indicates  that  the  user 
does  not  want  SPICE  to  solve  for  the  quiescent  operating  point  before  beginning  the 
transient  analysis.  If  this  keyword  is  specified,  SPICE  uses  the  values  specified  using  IC>... 
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on  the  various  elements  as  the  initial  transient  condition  and  proceeds  with  the  analysis. 
If  the  JC  card  hu  been  specified,  then  the  node  voltages  on  the  JC  card  are  used  to  com¬ 
pute  the  intitial  conditions  for  the  devices.  Lodt  at  the  description  on  the  JC  card  for  its 
interpretation  when  UIC  is  not  qiecified. 

9.14.  .FOUR  Card 
General  form: 

.FOUR  FREQ  OVl  <  OV2  OV3  ...> 

Esamplca: 

.FOURIODK  V(S) 

This  card  controls  whether  SPICE  performs  a  Fourier  analyns  as  a  part  of  the  tran¬ 
sient  analysis.  FREQ  is  the  fundamental  frequency,  and  OVl, ....  are  the  output  variables  for 
which  the  analysis  is  desired.  The  Fourier  analyns  is  performed  over  the  interval  <  TSTOP- 
period,  TSTOP> ,  where  TSTOP  is  the  final  time  specified  for  the  transient  analysis,  and 
period  is  one  period  of  the  fundamental  frequency.  The  dc  component  and  the  first  nine 
components  are  determined.  For  maximum  accuracy,  TMAX  (see  the  .TRAN  card)  should 
be  set  to  period/lOOD  (or  leas  for  very  high-Q  circuits). 

9.15.  J»RINT  Cards 
General  farm: 

JPRINT  PRTYPE  OVl  <OV2  ...  OV8> 

Examples: 

.PRINT  TRAN  V(4)  I(VIN) 

.PRINT  AC  VM(4,2)  VR(7)  VP(t3) 

.PRINT  DC  V(2)  I(VSRC)  V(23,17) 

.PRINT  NOISE  INOISE 
.PRINT  DISTO  HD3  SIM2(DB) 

This  card  defines  the  contents  of  a  tabular  listing  of  one  to  eight  output  variables. 
PRTYPE  is  the  type  of  the  analysis  (DC,  AC.  TRAN,  NOISE,  or  DISTO)  ftir  which  the 
specified  outputs  are  desired.  The  form  for  voltage  or  current  output  variables  is  as  follows: 

V(N1<  ,N2>  )  specifies  the  voltage  difference  between  nodes  N1  and  N2.  If  N2  (and  the 
preceding  comma)  is  omitted,  ground  (0)  is  assumed.  For  the  ae  analysis, 
five  additional  outputs  can  be  secerned  by  replacing  the  letter  V  by: 

VR  •  real  part 
VI  -  imaginaty  part 
VM  -  magnitude 
VP  -  phase 

VDB-  2  O-Iog  10  (magnitude) 

I(VXXXXXXX)  specifies  the  current  flowing  in  the  independent  voltage  source  named 
VXXXXXXX.  Positive  current  flows  from  the  positive  node,  through  the 
source,  to  the  negative  node.  For  the  ac  analysis,  the  corresponding 
replacements  for  the  letter  I  may  be  made  in  the  same  way  as  described 
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for  voltige  outputs. 

Output  variables  for  the  noise  and  distortion  analyses  have  a  different  general  form 
from  that  of  the  other  analyses,  ix. 

OV<(X)> 

where  OV  is  any  of  ONOISE  (output  noise).  INOISE  (equivalent  input  noise),  D2,  HD3, 
SIM2,  DIM2,  or  DIM3  (see  description  of  distortimi  analysis),  and  X  may  be  any  of: 

R  •  real  part 
I  -  imaginary  part 

M  -  magnitude  (default  if  nothing  q)ecified) 

P  •  phase 

DB  •  2  O'log  1 0  (magnitude) 

thus,  SIM2  (or  SIM2(M))  describes  the  magnitude  of  the  SIM2  distortion  measure,  while 
HD2(R)  describes  the  real  part  of  the  HD2  distmtion  measure. 

There  is  no  limit  on  the  number  of  PRINT  cards  for  each  type  of  analysis. 

9M.  PLOT  Cards 
General  form: 

PLOT  PLTYPE  OVl  <  (PLOipHIl)>  <  OV2  <(PL02PH12)>  ...  OVS> 

Esamples: 

PLOT  DC  V(4)  V(5)  V(l) 

PLOT  TRAN  V(17,5)  (23)  I(VIN)  V(17)  (13) 

PLOT  AC  VM(5)  VM(3144)  VDB(5)  VP(5) 

PLOT  OISTO  HD2  HD3(R)  S1M2 
PLOT  TRAN  V(S3)  V(4)  (03)  V(7)  (0,10) 

This  card  defines  the  contents  of  one  plot  of  from  one  to  eight  output  variables. 
PLTYPE  is  the  type  of  analysis  (DC,  AC,  TRAN,  NOISE,  or  DISTO)  for  which  the 
specified  outputs  are  desired.  The  syntax  for  the  OVI  is  identical  to  that  for  the  PRINT 
card,  describe  above. 

The  optional  plot  limits  (PLOPHI)  may  be  specified  after  any  of  the  output  variables. 
All  output  variables  to  the  left  of  a  pair  of  plot  limits  (PLOPHI)  will  be  plotted  using  the 
same  lower  and  upper  plot  bounds.  If  plot  limits  are  not  specifi^,  SPICE  will  automatically 
determine  the  minimum  and  maximum  values  of  all  output  variables  being  plotted  and  scale 
the  plot  to  fit.  More  than  one  scale  will  be  used  if  the  output  variable  values  warrant  (i.e., 
mixing  output  variables  with  values  which  are  ordersK>f-magnitude  different  still  gives  read* 
able  plots). 

The  overlap  of  two  or  more  traces  on  any  plot  is  indicated  by  the  letter  X. 

When  more  than  one  output  variable  appears  on  the  same  plot,  the  first  variable 
specified  will  be  printed  as  well  as  plotted.  If  a  printout  of  all  variables  is  desired,  then  a 
companion  PRINT  card  should  be  included. 

There  is  no  limit  on  the  number  of  PLOT  cards  specified  for  each  type  of  analysis. 

10.  APPENDIX  A:  EXAMPLE  DATA  DECKS 
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10.1.  Ctrcottl 

The  following  deck  determines  the  dc  operating  point  and  small'Signal  transfer  func¬ 
tion  of  a  simple  differential  pair.  In  addition,  the  ac  small-signal  response  is  computed  over 
the  frequency  range  IHz  to  lOOMEGHz. 

SIMPLE  DIFFERENTIAL  PAIR 

VCC  7  0 12 

VEE  8  0  -12 

VIN  1 0  AC  1 

RSI  12  IK 

RS2  6  0  IK 

Q1  3  2  4  MODI 

Q2  S  6  4  MODI 

RCl  7  3  lOK 

RC2  7  S  lOK 

RE  4  8  lOK 

AfODEL  MODI  NPN  BF=50  VAF=50  IS*1JS-12  RB^lOO  CJC=APF  TF=ANS 
.TF  V(5)  VIN 
AC  DEC  10  1  lOOMEG 
JLOT  AC  VM(5)  VP(5) 

JRINT  AC  VM(5)  VP(5) 

£ND 


10  J.  Clrcnlt  2 

The  following  deck  computes  the  output  characteristics  of  a  MOS-  FET  device  over  the 
range  O-IOV  for  VDS  and  0-5V  for  VGS. 

MOS  OUTPUT  CHARACTERISTICS 
.OPTIONS  NODE  NOPAGE 
VDS  3  0 
VGS  2  0 

Ml  1  2  0  0  MODI  L=4U  W»6U  AD=10P  AS^lOP 
MODEL  MODI  NMOS  VTO»-2  NSUB^UOEIS  UO»SS0 

*  VIDS  MEASURES  ID.  WE  COULD  HAVE  USED  VDS.  BUT  ID  WOULD  BE  NEGATIVE 
VIDS  3  1 

JX:  VDS  0  10  A  VGS  0  S  1 
J*RINT  DC  I(VIDS)  V(2) 

JT,OT  DC  I(VILi) 

£ND 


10 J.  CIrcattS 

The  following  deck  determines  the  dc  transfer  curve  and  the  transient  pulse  response 
of  a  simple  RTL  inverter.  The  input  is  a  pulse  from  0  to  S  Volts  with  delay,  rise,  and  fall 
times  of  2ns  and  a  pulse  width  of  30ns.  The  transient  interval  is  0  to  100ns,  with  printing  to 
be  done  every  nanosecond. 
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SIMPLE  RTL  INVERTER 
VCC  4  0  5 

VIN  1  0  PULSE  0  S  2NS  2NS  2NS  30NS 

RB  1  2  lOK 

Q1  3  2  0  Q1 

RC3  4  IK 

J^OT  DC  V(3) 

PLOT  TRAN  V(3)  (04) 

PRINT  TRAN  V(3) 

MODEL  Q1  NPN  BF  20  RB  100  TF  .INS  CJC  2PF 
JX:  VIN  0  5  0.1 
.TRAN  INS  lOONS 
PND 


10.4.  Clrcnit  4 

The  following  deck  simulates  a  four-bit  binary  adder,  using  several  subcircuits  to 
describe  various  pieces  of  the  overall  circuit. 

ADDER  -  4  BIT  ALL-NAND-GATE  BINARY  ADDER 
•••  SUBCIRCUIT  DEFINITIONS 

5UBCKT  NAND  12  3  4 

•  NODES:  INPUT(2),  OUTPUT,  VCC 
01  9  S  1  QMOD 
DICLAMPOIDMOD 

Q2  9  5  2  QMOD 

D2CLAMP  0  2  DMOD 

RB4S4K 

R1  4  6 14K 

Q3  6  9  8  QMOD 

R2  8  0  IK 

RC4  7  130 

Q4  7  6  10  QMOD 

DVBEDROP  10  3  DMOD 

QS  3  8  0  QMOD 

PNDS  NAND 

BUBCKT  ONEBIT  12  3  4  5  6 

•  NODES:  INPUT(2),  CARRY-IN,  OUTPUT,  CARRY-OUT,  VCC 
XI  1 2  7  6  NAND 

X2  1 7  8  6  NAND 
X3  2  7  9  6  NAND 
X4  8  9  10  6  NAND 
XS  3  10  11 6  NAND 
X6  3  11  12  6  NAND 
X7  10  11  13  6  NAND 
X8  12  13  4  6  NAND 
X9  11  7  5  6  NAND 
PNDS  ONEBIT 
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5UBCKT  TWOBIT  123456789 

•  NODES:  INPUT  -  BIT0(2)  /  Bm(2),  OUTPUT  -  BITO  /  BITl, 

•  CARRY-IN,  CARRY-OUT.  VCC 
XI  1  2  7  5  10  9  ONEBIT 

X2  3  4  10  6  8  9  ONEBIT 
£NDS  TWOBIT 

5UBCKT  FOURfilT  1  2  3  4  5  6  7  8  9  10  11  12  13  14  IS 

•  NODES:  INPUT  -  BIT0(2)  /  BIT1(2)  /  Brr2(2)  /  BIT3(2), 

•  OUTPUT  -  BITO/Bm/BIT2/BIT3,CARRY-IN.CARRY-OUT,VCC 
XI  1  2  3  4  9  10  13  16  15  TWOBIT 

X2  5  6  7  8  11 12  16  14  15  TWOBIT 
£NDS  FOURBIT 

•••  DEFINE  NOMINAL  CIRCUIT 

MODEL  DMOD  D 

MODEL  QMOD  NPN(BF=75  RB^lOO  CJE=1PF  CJC=3PF) 

VCC  99  0  DC  5V 

VINIA  1  0  PULSE(0  3  0  IONS  IONS  IONS  SONS) 

VINIB  2  0  PULSE(0  3  0  IONS  IONS  20NS  lOONS) 

VIN2A  3  0  PULSE(0  3  0  IONS  IONS  40NS  200NS) 

VIN2B  4  0  PULSE(0  3  0  IONS  IONS  SONS  400NS) 

VIN3A  5  0  PULSE(0  3  0  1(H4S  IONS  160NS  800NS) 

VIN3B  6  0  PULSE(0  3  0  IONS  IONS  X20NS  1600NS) 

VIN4A  7  0  PULSE(0  3  0  IONS  IONS  640NS  3200NS) 

VIN4B  8  0  PULSE(0  3  0  IONS  IONS  1280NS  6400NS) 

XI  12  3  4  5  6  7  8  9  10  11  120  13  99  FOURBIT 

RBITO  9  0  IK 

RBITIIOOIK 

RBIT2  11  0  IK 

RBIT3  12  0  IK 

RCOUT  13  0  IK 

PLOT  TRAN  V(l)  V(2)  V(3)  V(4)  V(5)  V(6)  V(7)  V(8) 

PLOT  TRAN  V(9)  V(10)  V(ll)  V(12)  V(13) 

PRINT  TRAN  V(l)  V(2)  V(3)  V(4)  V(5)  V(6)  V(7)  V(8) 

PRINT  TRAN  V(9)  V(10)  V(ll)  V(12)  V(13) 

•••  (FOR  THOSE  WITH  MONEY  (AND  MEMORY)  TO  BURN) 
.TRAN  INS  6400NS 

.OPTIONS  ACCT  LIST  NODE  LIMPTS*6401 
£ND 


lOS.  CtreoltS 

The  following  deck  simulates  a  transmission-line  inverter.  Two  transmission-line  ele¬ 
ments  are  required  since  two  propagation  modes  are  excited.  In  the  case  of  a  coaxial  line,  the 
first  line  (Tl)  models  the  inner  conductor  with  respect  to  the  shield,  and  the  second  line 
(T2)  models  the  shield  with  respect  to  the  out-  side  world. 
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TRANSMISSION-LINE  INVERTER 
VI  1  0  PULSE(0  1  0  O.IN) 

R1  12  50 

XI  2  0  0  4  TLINE 

R240S0 

5UBCKT  TLINE  12  3  4 
T1  1  2  3  4  Z0=50  TD=1^S 
T2  2  0  4  0  Z0=100  TD=1NS 
JENDS  TLINE 
•TRAN  O.INS  20NS 
J»LOT  TRAN  V(2)  V(4) 

£ND 

11.  APPENDIX  B:  NONLINEAR  DEPENDENT  SOURCES 

SPICE  allows  circuits  to  contain  dependent  sources  charac  terized  by  any  of  the  four 
equations 

i=f(v)  v=f(v)  i=f(i)  v=f(i) 

where  the  functions  must  be  polynomials,  and  the  arguments  may  be  multidimensional.  The 
polynomial  functions  are  specified  by  a  set  of  coefficients  pO,  pi, ...,  pn.  Both  the  number  of 
dimensions  and  the  number  of  coefficients  are  arbitrary.  The  meaning  of  the  coefficients 
depends  upon  the  dimension  of  the  polynomial,  as  shown  in  the  following  examples: 

Suppose  that  the  function  is  one-dimensional  (that  is,  a  function  of  one  argument). 
Then  the  function  value  fv  is  determined  by  the  following  expression  in  a  (the  function  argu¬ 
ment): 

fv  =  p0  +  pl*a  +  p2'a^+p3*a^  +  p4*a^  +  p5-a^  +  ,.. 

Suppose  now  that  the  function  is  two-dimensional,  with  arguments  a  and  b.  Then  the 
function  value  fv  is  determined  by  the  following  expression: 

fv  =  p0+pl*a  +  p2-b+p3-a^  +  p4*a-b+p5-b^  +  p6-a^  + 

p7-a^b  +  p8*a*b^+p9’b^  +  ... 

Consider  now  the  case  of  a  three-dimensional  polynomial  function  with  arguments 
a,  b,  and  c.  Then  the  function  value  fv  is  determined  by  the  following  expression: 

fv  =  p0  +  pl*a  +  p2*b  +p3*c  +p4-a^  +  p5'a-b  + 

pfi'X'C  +  p7-b^  +  p8-b’C  +  p9'C^  +  plO*a^  + 

pll-a2’b  +  pl2*a2'C+pl3-a-b2  +  pl4-a’b*c  + 

pl5-a*c2  +  pl6*b^4pl7*b^-c  + 

pl9c3  +  p20-a^  +  ... 

Note:  if  the  polynomial  is  one-dimensional  and  exactly  one  coefficient  is  specified,  then 
SPICE  assumes  it  to  be  pi  (and  pO  -  0.0),  in  order  to  facilitate  the  input  of  linear  con¬ 
trolled  sources. 

For  all  four  of  the  dependent  sources  described  below,  the  initial  condition  parameter 
is  described  as  optional.  If  not  specified,  SPICE  assumes  0  the  initial  condition  for  depen¬ 
dent  sources  is  an  initial  initial  condition  to  obtain  the  dc  operating  point  of  the  circuit. 
After  convergence  has  been  obtained,  the  program  continues  iterating  to  obtain  the  exact 
value  for  the  controlling  variable.  Hence,  to  reduce  the  computational  effort  for  the  dc 
operating  point  (or  if  the  polynomial  specifies  a  strong  nonlinearity),  a  value  fairly  close  to 
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the  actual  controlling  variable  should  be  specified  for  the  initial  condition. 

11.1.  Voltage^BtroUcd  Current  Sonrees 
General  form: 

GXXXXXXX  N-t-  N-  <POLY(ND)>  NCl-t-  NCI-  ...  PO  <P1  ...>  <1C»...> 

Esamplca: 

G1 1 0  5  3  0  0.1M 

GR  17  3  17  3  0  IM  1.SM  IC=2V 

GMLT  23  17  POLY(2)  3  S  1  2  0  IM  17M  3  JU  IC-2.5, 1 J 

N+  and  N-  are  the  positive  and  negative  nodes,  respectively.  Current  flow  is  from  the 
positive  node,  through  the  source,  to  the  negative  node.  POLY(ND)  only  has  to  be 
specified  if  the  source  is  multi-dimensional  (one-dimensional  is  the  default).  If  specified,  ND 
is  the  number  of  dimensions,  which  must  be  positive.  NC1+,  NC1-, ...  Are  the  positive  and 
negative  controlling  nodes,  respectively.  One  pair  of  nodes  must  be  specified  for  each 
dimension.  PO,  PI,  P2,  .~,  Pn  are  the  polynomial  coefficients.  The  (optional)  initial  con¬ 
dition  is  the  initial  guess  at  the  value(s)  of  the  controlling  voitage(s).  If  not  specified, 
0.0  is  assumed.  The  polynomial  specifies  the  source  current  as  a  function  of  the  controlling 
voltage(s).  The  second  example  above  describes  a  current  source  with  value 

I-lO-3.v(27,3)  +  1.5xl0“3.v(17,3)2 

note  that  since  the  source  nodes  are  the  same  as  the  controlling  nodes,  this  source  actually 
models  a  nonlinear  resistor. 

IIJ.  Veltagi  Controlled  Voltags  Sonress 

General  farm: 

EXXXXXXX  N+  N-  <  POLY(ND)>  NCl-t-  NCI-  ...  PO  <  PI  ...>  <  IC«...> 

Examples: 

El  3  4  21 17  10 J  2.1 1.75 

EX  17  0  POLY(3)  130150  17  00111  IC«U4^,17  J5 

N-t-  and  N-  are  the  positive  and  negative  nodes,  respectively.  POLY(ND)  only  has  to 
be  specified  if  the  source  is  muFti-  dimensional  (one-dimensional  is  the  default).  If 
specified,  ND  is  the  number  of  dimensions,  whidi  must  be  positive.  NCl-t-,  NC1-, ...  are  the 
positive  and  negative  controlling  nodes,  respectively.  One  pair  of  nodes  must  be  specified 
for  each  dimension.  PO,  PI,  P2,  ...,  Pn  are  the  polynomial  coefficients.  The  (optional) 
initial  condition  is  the  initial  guem  at  the  valoe(s)  of  the  controlling  voltage(s).  If  not 
specified,  0.0  is  assumed.  The  polynomial  specifies  the  source  voltage  as  a  function  of  the 
controlling  voltage(s).  The  second  example  above  describes  a  voltage  source  with  value 

V  -  V(13,0)  +  V(15,0)  -I-  V(17,0) 

(in  other  words,  an  ideal  voltage  summer). 
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lU.  Corrent'Cootroikd  Current  Sources 
Geucrul  form: 

FXXXXXXX  N+  N-  <POLY(ND)>  VNl  <  VN2  ^.>  PO  <P1  ...>  <IC»...> 

Examples: 

FI  12  10  VCC  IMA  1 JM 

FXFER  13  20  VSENS  0  1 

N-f-  and  N*  are  the  positive  and  negative  nodes,  respectively.  Current  flow  is  from  the 
positive  node,  through  the  source,  to  the  negative  node.  roLY(ND)  only  has  to  be 
specified  if  the  source  is  multi-dimensional  (one-dimensional  is  the  default).  If  specified,  ND 
is  the  number  of  dimensions,  which  must  be  positive.  VNl,  VN2,  ...  are  the  names  of  vol¬ 
tage  sources  through  which  the  controlling  current  flows;  one  name  must  be  specified  for 
each  dimension.  The  direction  of  positive  controlling  current  flow  is  from  the  positive 
node,  through  the  source,  to  the  negative  node  of  each  voltage  source.  PO,  PI,  P2,  ...,  Pn 
are  the  polynomial  coefficients.  The  (optional)  initial  condition  is  the  initial  guess  at  the 
value(s)  of  the  controlling  current(s)  (in  Amps).  If  not  q>ecified,  0.0  is  assumed.  The  poly¬ 
nomial  specifies  the  source  current  as  a  function  of  the  controlling  curTent(s).  The  first  exam¬ 
ple  above  describes  a  current  source  with  value 

I  =  10"3  +  1.3x10"3.(vCC) 

11.4.  Curreut-Cootrolled  VolCage  Sources 
Geucrul  farm: 

HXXXXXXX  N+  N-  <P0LY(ND)>  VNl  <  VNl  ...>  PO  <P1  ...>  <IC=...> 

Examples: 

HXY  13  20  POLY(2)  VINl  VIN2  0  0  0  01 IC-OJ  IJ 

HR  4  17  VX  0  0  1 

N-f  and  N-  are  the  positive  and  negative  nodes,  respectively.  POLY(ND)  only  has  to 
be  specified  if  the  source  is  multi-  dimensional  (one-dimensional  is  the  default).  If 
specified,  ND  is  the  number  of  dimensions,  which  must  be  positive.  VNl,  VN2,  are  the 
names  of  voltage  sources  through  which  the  controlling  current  flows;  one  name  must  be 
specified  for  each  dimension.  The  direction  of  positive  controlling  current  flow  is  from  the 
positive  node,  through  the  source,  to  the  negative  node  of  each  voltage  source.  PO,  PI,  P2, 
...,  Pn  are  the  polynomial  coefficients.  The  (optional)  initial  condition  is  the  initial  guem 
at  the  value(s)  of  the  controlling  current(s)  (in  Amps).  If  not  specified,  OX)  is  asntmed. 
The  polynomid  specifies  the  source  voltage  as  a  function  of  the  controlling  current(s).  The 
first  example  above  describes  a  voltage  source  with  value 

V-I(VIN1)I(VIN2) 

12.  APPENDIX  C:  BIPOLAR  MODEL  EQUATIONS 
Acknowledgment:  This  section  has  been  contributed  by  Bill  Bider-  mann  at  HP  labs. 

(Gmin  terms  omitted) 
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12.1  O.C.  MODEL 

IB-J|(e(N^)^^ -l)+B|^(e(Nlft^^^  _l)  +  ISE(e(N^^’^ -l)  +  ISC(e(N<?)^^-l) 

NOTE:  The  last  two  terms  in  the  expression  of  the  base  current  IB  represent  the  components 
due  to  recombination  in  the  BE  and  BC  space  charge  regions  at  low  injection. 

If  IRB  not  specified 

RBB  =  RBM 

If  IRB  specified 

R  B  B  »  3  (RB  -  RBM  )  [  ^  ^  RBM 1 

Where: 

24/w2\|B7niB) 

QB=^il(l+\rTTTO) 

Qln  ~4 - SSSS 

1  vwr  VHP 
‘  VAF  VaR 

NOTE:  IRB  is  the  current  where  the  base  resistance  falls  halfway  to  its  minimum  value. 

VAF  and  VAR  are  forward  and  reverse  Early  voltages  respectively.  IKF  and  IKR  determine 
the  high  current  beta  rolloff  with  IC.  ISE,  ISC,  NE  and  NC  determine  the  low  current 
beta  rolloff  with  IC. 

UJ  AX:.  MODEL 

CBE=j^I(TFF^e(N^)^ -D+CJECl-^j^)"*") 

Where: 

TIT  - TF ( 1  +  XTF  •  (nr{^Tp2)  .el-44^^fF" 

IF-IS(e(NPS^  -1) 

CBI-CBC‘(1-XCJC) 

CB2-CBCXCJC 

CBC-TR<^jqfJ^Te‘^^^  )  +  aC(l-^5^)"MJC 

CSS  =  CJS  ( 1 

NOTE:  all  Jnnctlon  capacltaneea  ef  the  farm  CO*(  1  revert  te  the  ferns 

when  V  >  FC-phi  (  For  CSS  aMnnue  FC  «  0  ) 
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12^  NOISE  MODEL 
Thermal  Noise  : 

IRBB^-^BBAf 

IRC2=^|sTAf 

Note:  The  first  two  terms  are  shot  noise  and  the  last  term  is  flicker  noise. 
ICN2-2qICAf 

Note:  This  is  shot  noise. 


U.4  TEMPERATURE  EFFECTS 

All  junctions  have  dependences  identical  to  the  diode  model  but  all  N  factors  are  con* 
sidered  equal  1. 

BF  and  BR  go  as  when  NF«1.  This  is  done  through  appropriate  changes 

in  BF  ,  BR  and  ISE,  ISC  according  to  the  following  equations  respectively: 

IS  i  . 


UJ5  EXCESS  PHASE 

This  is  a  delay  (linear  phase)  in  the  gm  generntor  in  AC  analysis.  It  is  also  used 
in  transient  analysis  using  a  Bessel  pol)momial  approximation.  Excess  phase,  PTF,  is  specified 
u  the  number  of  extra  degrees  of  phase  at  the  frequency 

'  ^Tw^Herti 

12.  APPENDIX  D:  ALTER  STATEMENT  AND  THE  SOURCE-STEPPING  METHOD 
The  ALTER  statement  allows  SPICE  to  run  with  altered  circuit  parameters. 


General  form: 

ALTER 

ELEMENT  CARDS  (DEVICE  CARDS.  MODEL  CARDS) 
ALTER  (or  £ND  CARD) 


Examples: 

R1  lOSK 
VCC3  010 

Ml  3  2  0  MODI  L-SU  W-2U 

MODEL  MODI  NMOS(VTO»li>  KP«2jOE*S  PHI>0A  NSUB«2.0E15  TOX>0.1U) 
ALTER 
R1  1  0  3JK 
VCC  3  0  12 

Ml  3  2  0  MODI  L-lOU  W=2U 


UW/NW  VLSI  Release  2.1  -  35  • 


10/1/83 


IV.v 


*  k  ■•■W  ■  .  .-Jrw’-k  AJ.  .-J.  JLk>.  .>  -  ./■O... 


>  - 


UW/NW  VLSI  Consortium 


SPICE  User's  Guide 


MODEL  MODI  NMOS(VTO=12  KP=2jOE-5  PHI=0^  NSUB=5jOE15  T0X=1^) 

ALTER 

Ml  3  2  0  MODI  L»10U  W»4U 
£ND 

This  cird  introduees  the  element(s).  deviee(s)  and  model(s)  whose  parameters  are 
changed  during  the  execution  of  the  input  deck.  The  vanalyses  specified  in  the  deck  will  start 
over  again  with  the  changed  parameters.  The  ALTER  card  with  the  cards  defining  the 
new  parameters  should  be  placed  just  before  the  £ND  card.  The  syntax  for  the  element  (dev* 
ice,  model)  cards  is  identical  to  that  of  the  cards  with  the  original  parameters. 

There  is  no  limit  on  the  number  of  ALTER  cards  and  the  circuit  will  be  re-analyzed  as 
many  times  as  the  number  of  ALTER  cards.  Subsequent  ALTER  operations  employ  parame¬ 
ters  of  the  previous  change.  No  topological  change  of  the  circuit  is  allowed. 

The  source-stepping  method  can  enhance  DC  convergence.  But  it  is  slower  than 
direct  use  of  the  Newton-Raphson  method.  Therefore  it  is  best  used  as  an  alternative  to 
achieve  convergence  of  DC  operating  point  when  the  circuit  fails  to  converge  by  using  the 
Newton-Raphson  method.  The  source-stepping  method  is  used  by  SPICE  when  the  variable 
ITL6  in  the  .OPTIONS  card  is  set  to  the  iteration  limit  at  each  step  of  the  source(s). 
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Designing  Finite  State  Machines  Yrith  PEG 

Cordon  Hamachi 

University  of  California  at  Berkeley 
ABSTRACT 

PEG  is  a  finite  state  machine  compiler.  It  translates  high  level 
language  descriptions  of  finite  state  machines  into  the  logic  equa¬ 
tions  needed  to  implement  state  machine  designs.  Since  the  out¬ 
put  format  is  compatible  with  egnfoff,  PEG  may  be  used  as  a  front 
end  for  Berkeley  PLA.  tools. 

1.  Introduction. 

PEG  (PLA  Equation  Generator)  is  a  design  tool  for  finite  state  machines.  It 
compiles  high  level  language  descriptions  of  finite  state  machines  into  the  logic 
equations  needed  to  implement  a  design. 

/’fi’G  programs  are  Isomorphic  to  Moore  machine  state  diagrams.  There  is  a 
one-to-one  correspondence  between  states  in  a  state  diatgram  and  state 
definitions  in  the  corresponding  PEG  program.  The  translation  from  state 
diagrams  to  PEG  programs  is  simple  and  straightforward. 

Designing  with  PEG  provides  a  number  of  advantages  over  the  traditional 
pencil-and-paper  approach  method  of  FSM  design.  PEG'S  high  level  language 
enables  designs  and  design  changes  to  quickly  be  implemented.  PEG  programs 
provide  easy-to-understand  documentation  with  clear  control  flow.  PEG  does  the 
tedious  and  error-prone  bookkeeping  task  of  generating  output  and  next  state 
bits  as  a  function  of  current  state  bits.  It  checks  for  design  errors  and  elim¬ 
inates  redundant  terms  in  logic  equations. 

As  output  PEG  generates  logic  equations  in  the  eqn  format  accepted  by 
eqntott  [Cmelik],  another  Berkeley  design  tool.  By  piping  the  output  of  PEG 
through  eqntott,  PEG  may  be  used  as  a  front  end  for  Berkeley  PLA  tools  such  as 
tpla  [Mayo],  mkpla  [Landman],  presto  [Fang],  and  plasort  [Kleckner&Landman]. 
As  an  option,  PEG  will  also  print  the  unminimized  truth  table  from  which  the 
logic  equations  are  derrived. 

2.  A  Simple  Example 

Designing  finite  state  machines  using  PEC  is  introduced  with  a  very  simple 
example.  Figure  1  shows  the  state  diagram  for  a  four-state  machine  implement¬ 
ing  a  2-bit  binary  counter.  The  PEC  program  implementing  this  design  is  shown 
in  figure  2. 
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Figure  1:  State  Diagram  for  Example  1 


—Simple  PEG  program  for  2-bit  counter 
—State  transition  on  every  clock 
—No  reset  =>  starts  in  a  random  state 


!  Start  —This  is  state  0 

I  :  —This  is  state  1 

I  :  -This  is  state  2 

:  —This  is  state  3 

I  GOTO  Start: 


Figure  2:  Pfi'G  Program  for  Example  1 


The  PEG  program  in  figure  2  consists  of  four  state  descriptions.  The  pro¬ 
gram  has  no  inputs.  The  outputs  of  the  state  machine  are  its  mxt  state  bits, 
which  are  autorhatically  generated  by  PEG. 

In  its  most  simple  form,  a  PEG  program  consists  of  a  list  of  state  descrip¬ 
tions.  The  sample  program  has  four  states.  Each  state  has  four  parts:  an 
optional  label,  a  colon,  an  optional  signal  assertion  part,  and  and  optional  con¬ 
trol  part. 

The  first  state  in  the  example  is  labeled  with  the  identifier  Start.  The  label 
is  necessary  only  because  of  the  GOTO  from  state  3  back  to  state  0. 

States  1  and  2  are  examples  of  the  minimal  state  description.  These  states 
are  completely  defined  by  a  colon,  which  acts  as  a  place  holder  for  the  state. 
Empty  states,  in  which  no  branching  or  signal  assertions  occur,  are  sometimes 
used  to  introduce  necessary  delays  in  FSMs. 

Flow  of  control  in  PEG  programs  is  sequential  unless  otherwise  specified. 
Since  no  control  information  is  present  for  states  0,  1,  and  2,  the  program  steps 
sequentially  through  the  states  0.  1.  2,  and  3.  State  3  has  control  information 
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The  INORDER  and  OUTORDER  statemeiits  specify  that  the  resulting  PLA 
inputs  and  outputs,  from  left  to  right,  are  InStO*.  InStl*.  OutStl*.  and  OutStO*. 

Following  the  OUTORDER  statement  are  the  logic  equations  for  the  two  out¬ 
put  variables.  OutStl*  and  OutStO*.  The  exclaimation  mark  "1"  indicates  logical 
negation.  The  ampersand  "lc“  signifies  the  logical  AND,  while  the  vertical  bar 
signifies  a  logical  OR. 

3.2.  'Druth  Table 

The  -i  option  generates  a  truth  table  for  the  flr.iie  state  machine.  This  truth 
table  is  written  to  the  file  jmg. summary.  The  truth  table  for  example  1  is  sho^vn 
in  figure  4. 


Figure  4:  Truth  Table  for  Example  1. 


Labels  across  the  top  of  the  truth  table  identify  its  columns.  The  mapping 
from  column  labels  to  actual  signal  names  is  given  in  the  lists  of  input  and  out¬ 
put  signals  which  preceed  the  truth  table.  To  the  right  of  the  truth  table  are  the 
names  of  the  states  described  by  the  rows  of  the  table. 

4.  Another  Example 

The  second  and  more  complex  example  shows  the  state  diagram  and 
corresponding  PEG  program  for  a  FSM  which  recognizes  the  grammar  (110)*100. 
The  state  diagram  for  this  FSM  is  shown  in  figure  5. 

The  PEG  program  which  implements  this  design  is  given  in  figure  6.  Figure 
6  describes  a  state  machine  with  four  states.  The  state  machine  has  two  inputs, 
RESET  and  in,  and  one  output,  accept. 

Assume  the  text  of  figure  2  is  in  a  fiie  called  prop.  Logic  equations  for  the 
state  machine  are  generated  by  running  the  command 

pep  prop 
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ABSTRACT 

PEG  is  a  finite  state  machine  compiler.  It  translates  high  level 
language  descriptions  of  finite  state  machines  into  the  logic  equa¬ 
tions  needed  to  implement  state  machine  designs.  Since  the  out¬ 
put  format  is  compatible  with  eqntott,  PEG  may  be  used  as  a  front 
end  for  Berkeley  PLA  tools. 


1.  Introduction 

PEG  (PLA  Equation  Generator)  is  a  design  tool  for  finite  state  machines.  It 
compiles  high  level  language  descriptions  of  finite  state  machines  into  the  logic 
equations  needed  to  implement  a  design. 

PEG  programs  are  isomorphic  to  Moore  machine  state  diagrams.  There  is  a 
one-to-one  correspondence  between  states  in  a  state  diagram  and  state 
definitions  in  the  corresponding  PEG  program.  The  translation  from  state 
diagrams  to  PEG  programs  is  simple  and  straightforward. 

Designing  with  PEG  provides  a  number  of  advantages  over  the  traditional 
pencil-and-paper  approach  method  of  FSM  design.  PEG'S  high  level  language 
enables  designs  and  design  changes  to  quickly  be  implemented.  PEG  programs 
provide  easy-to-understand  documentation  with  clear  control  flow.  PEG  does  the 
tedious  and  error-prone  bookkeeping  task  of  generating  output  and  next  sfofe 
bits  as  a  function  of  current  state  bits.  It  checks  for  design  errors  and  elim¬ 
inates  redundant  terms  in  logic  equations. 

As  output  PEG  generates  logic  equations  in  the  egn  format  accepted  by 
eqntott  [Cmelik],  another  Berkeley  design  tool.  By  piping  the  output  of  PEG 
through  eqntott,  PEG  may  be  used  as  a  front  end  for  Berkeley  PLA  tools  such  as 
tpla  [Mayo],  mkpla  [Landman],  presto  [Fang],  and  plasort  [Kleckner&Landman]. 
As  an  option,  PEC  will  also  print  the  unminimized  truth  table  from  which  the 
logic  equations  are  derrived. 

2.  A  Simple  Example 

Designing  finite  state  machines  using  PEG  is  introduced  with  a  very  simple 
example.  Figure  1  shows  the  state  diagram  for  a  four-state  machine  implement¬ 
ing  a  2-bit  binary  counter.  The  PEG  program  implementing  this  design  is  shown 
in  figure  2. 
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j  —Simple  FSM  example: 

i 

Accepts  the  grammar  (1  0)*100 

1 

INPUTS  : 

OUTPUTS  : 

RESET  InStream; 
accept; 

;  Top  : 

IF  NOT  InStream  THEN  LOOP; 

-0* 

i  Sawl 

IF  InStream  THEN  LOOP: 

~1 

: 

IF  InStream  THEN  Sawl; 

-10 

i 

ASSERT  accept; 

IF  InStream  THEN  Sawl  ELSE  Top: 

-100 

Figure  6:  PEG  Program  Recognizing  (1  0)*100 

« 

1 - 

INORDER 

1  OUTORDER 

OutStl* 

=  RESET  InStream  InStO'InStl*: 

=  OutStl*  OutStO*  Accept; 

-  (IRESET&  InStream)  1 

(!RESET&!lnStreamac  InStO-WlnStl*): 
OutStO*  a  (!RESET&!InStreamac  InStO'&'lnStl*) 

!lnStreamdc!]nStO*&  InStl*); 

Accept  a  ( In3t0*&  InStl*): 


Figure  7;  Equations  for  Example  2. 

called  accept.  The  FSM  asserts  this  signal  high  if  a  string  in  the  given  grammar 
is  recognized.  If  any  outputs  are  generated  by  a  PEC  program,  they  must  be 
declared  in  an  OUTPUTS  statement  which  immediately  follows  the  INPUTS 
statement.  If  no  INPUTS  statement  is  present,  then  the  OUTPUTS  statement  is 
the  first  program  statement. 

Example  2  introduces  the  IF-THEN-ELSE  control  construct.  This  construct 
is  used  to  provide  two-way  branches  bated  only  on  a  single  inpul  signal. 
Branches  based  on  more  than  one  input  signal  are  handled  by  the  CASE  state¬ 
ment  which  has  not  yet  been  presented.  IF  statements  do  not  nest:  Statements 
of  the  form  IF-THEN'ELSE~IF  are  not  adlowed.  The  syntax  of  the  IF  is: 

IF  [  NOT  ]  <signai>  THEN  <state  nama>  [  ELSE  <state  namt>  ]  ; 
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specifying  a  jump  back  to  the  state  labeled  Start. 

Since  it  has  no  sequential  next  state,  control  must  always  be  defined  for  the 
last  state  in  the  program.  PEG  generates  an  error  message  and  quits  if  control 
is  not  defined  for  the  last  state. 

Although  state  transitions  are  performed  on  clock  ticks,  no  clock  is  men¬ 
tioned  in  the  program.  It  is  the  user's  responsibility  to  implement  the  state 
machine  with  s>'nchronous  logic  to  latch  input  and  output  signals. 

Comments  begin  with  a  double  dash  ■  — '  and  terminate  at  the  end  of  the  line 
on  which  they  appear.  The  first  three  lines  of  the  program  are  comments.  Com¬ 
ments  also  appear  on  lines  5  through  8. 

Input  is  free-format.  White  space  may  appear  an>'whf!re  in  a  program  to 
enhance  readability. 

3.  Inbeipreting  the  Output 

Assuming  that  the  PE'S  program  for  example  1  is  in  a  fila  called  cawnter,  the 
following  Unix  command  line  may  be  used  to  invoke  PEG. 

peg  counter 

The  resulting  output  is  shov-n  in  figure  3.  Generating  a  PLA  from  the  same  input 
file  is  accomplished  with  the  command  line: 

peg  counter  eqntott mJepla  -i-o  -y  2 

The  digit  2  appears  on  the  command  line  as  an  argument  .o  mJepla  to  indicate 
that  there  are  2  state  bits  to  be  fed  back  from  the  output  to  the  input  of  the 
PLA.  In  order  specify  the  num.ber  of  state  bits  required,  it  may  be  necessary  to 
run  PEG  twice;  once  to  determine  the  number,  and  another  time  to  actually 
generate  the  PLA. 


i  INORDER 
I  OUTORDER 


OutStl* 

OutStO* 


InStO*  InStl*: 

OutStl*  OutStO*: 

(flnStl*): 

{  InStO*&!InStl»),  (!lnStO*&  InStl*); 


Figure  3:  PLA  Equations  for  Example  1. 


3.1.  Equations 

PEG  generates  the  two  input  variables  InStO*  arH  InStl*  which  are  the 
state  inputs  for  the  finite  state  machine.  It  also  generates  two  output  variables 
OuiStO*  and  OutStl*.  the  next-state  outputs.  Any  signed  name  ending  with  an 
asterisk  was  generated  by  PEC. 
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5.  Final  Ebcaznpie 

Figures  9  and  10  show  the  state  diagram  and  PEG  program  for  a  state 
machine  which  decodes  3  bits  into  0,  1.  2.  3,  and  "other  ".  Example  3  shows  the 
use  of  multiple  inputs,  multiple  outputs,  amd  multi-way  branches. 
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^0 


Figure  5:  State  Diagram  Recognizing  (1I0)*100 

Since  this  program  has  two  inputs,  they  are  declared  in  the  LVPUTS  state¬ 
ment.  If  a  PEG  program  has  any  inputs  they  must  be  declared  in  an  INPUTS 
statement  which  must  be  the  first  statement  in  the  program.  The  input  RESET 
is  a  special  kej'word  input.  The  other  program  input,  InStream,  is  used  to  gen¬ 
erate  the  next  state  tor  the  FSM. 

RESET  indicates  that  when  the  RESET  signal  is  asserted  the  state  machine 
jumps  to  the  top  of  the  program,  which  in  this  case  is  nauned  Top.  When  this 
keyword  is  present,  conditional  branches  to  the  first  state  are  automatically 
added  to  the  next  state  expressions  for  each  state.  If  RESET  is  not  listed  as  an 
input,  the  program  initializes  in  a  random  state. 

IF  the  FSM  designer  does  not  want  to  pay  the  penalty  of  a  larger  and  slower 
finite  state  machine,  RESET  may  be  omitted  as  it  was  in  example  1.  In  this  case 
the  reset  function  may  be  external  to  the  PEG  program  by  implementing  the 
FSM  in  such  a  manner  that  the  next  state  feedback  lines  are  pulled  low  when  the 
RESET  signal  is  asserted.  This  method  will  work  because  the  top  state  in  a  PEG 
program  is  always  assigned  to  state  zero. 

The  OUTPUTS  statement  declares  that  this  program  has  a  single  output 
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<Coatrol>  :  CASE  (  <Idezitifierlist>  )  <Cases>  <DefaultCaLse> 

I  IF  <1DENT1F1ER>  THEN  <1DENTIF1ER>  ; 

I  IF  <1DENTIFTER>  TlffiN  <IDENTIFIER>  ELSE  <IDENTIFIER>  ; 

I  IF  <NOT>  <IDENTIF1ER>  THEN  <IDENTIFIER>  : 

1  IF  <NOT>  <1DENTIF1ER>  THEN  <IDENTIFIER>  ELSE  <IDENTIFIER> 
1  GOTO  <IDENTIFIER> 

I  /’NULLV 

<CaseSLatemcnt>  :  <BitIist>  =>  <  IDE:NTIFIER>  ; 

<Cases>  :  <Cases>  <Casc!Stateinent>  |  <CaseStatemeat> 

<Bit>  :  0  I  1  I  ? 

<BitJList>  :  <BitIist>  <Bit>  j  <Bit> 

<DefaultCase>  :  ENDCASE  =>  <IDENTIFIER>  ;  |  ENDCASE  : 

<Naf>  :  ■ !"  I  "NCT'  1  • 

<Cbinmeat>  : 

<IDENT]FIER>  :  [A-Z;ais][A-Za-«>9.J* 
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INPUTS: 


OUTPUTS: 


iOO:  RESET 
iOl:  InStream 
sOO:  InStO*  (msb) 
sOl:  InStl*  (Isb) 

nOl:  OutStl*(lsb) 
nOO:  OutStO*  (msb) 
oOO:  Accept 


State  Table 

i 

0 

i 

1 

s 

0 

s 

1 

n 

1 

n 

0 

o 

0 

1 

- 

0 
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0 

0 

- 

Top 
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0 

0 

0 

0 

0 

- 

Top 

0 

1 

0 

0 

1 

0 

- 

Top 

1 

1 

• 

0 

1 

0 

0 

. 

Sawl 
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0 

0 

1 

0 

1 

- 

Sawl 

0 

1 

0 

1 

1 

0 

- 

Sawl 

1 

• 

1 

0 

0 

0 

• 

Saw'1+1 

0 

0 

1 

0 

1 

1 

- 

Sawl+1 

'  0 

1 

1 

0 

1 

0 

- 

Sawl+1 

1 

1 

1 

0 

0 

1 

Saw 1+2 

0 

0 

1 

1 

0 

0 

1 

Sawl +2 

0 

1 

1 

1 

1 

0 

1 

Sawl +2 

Figure  9:  Truth  table  for  Example  2. 


The  ELSE  clause  is  optional:  If  it  is  omitted,  the  ELSE  defauits  to  the  next 
sequential  state  in  the  program.  Thus,  in  state  Top,  if  InStream  is  high,  then  the 
condition  in  the  IF  is  false  and  the  program  takes  the  default  branch  to  state 
Sawl. 

The  alert  reader  will  have  noticed  that  the  state  name  LOOP  is  used  but  not 
defined.  This  is  intentional.  LOOP  is  a  keyword  which  means  to  stay  in  the 
current  state.  It  is  an  error  to  define  a  state  with  the  label  LOOP. 

The  final  state  in  example  2  shows  the  first  use  of  the  ASSERT  statement. 
The  accept  signal  is  asserted  only  in  the  accepting  state  of  the  FSM.  If  an 
ASSERT  statement  is  present  in  the  definition  of  a  state,  it  must  preceed  the 
state's  control  statement. 
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Alistract 

The  Lyra  layout  rule  checker  can  be  retargeted  to  new  design  rules,  permit¬ 
ting  Lyra  to  be  used  with  multiple  tachnologies  and  processes  and  also  mak¬ 
ing  it  possible  to  track  design  rules  as  they  change  over  time.  To  adapt  Lyra 
to  a  new  ruleset.  a  symbolic  ruleset  specification  is  written  and  then  com¬ 
piled  with  tne  Lyra  rule  compiler  to  generate  an  executable  module  for 
checking  the  new  rules.  Rules  eu'e  ispecified  in  terms  of  Lyra’s  corner  based 
paradigm:  Each  rule  gives  a  context  specifying  comers  where  it  applies,  and 
a  set  of  constraints  to  be  applied  at  these  comers.  Complex  or  unusual  rules 
can  be  ceded  directly  in  terms  of  a  primitive  rule  construct  Common 
checks,  such  as  width  and  spacing,  are  coded  more  concisely  using  rule  mac¬ 
ros. 

This  manual  gives  the  details  of  writing  rulesets  for  L3rra.  All  the  basic  con¬ 
structs  for  rule  specification  are  explained,  and  the  rule  macros  are  present¬ 
ed.  Compiling,  testing  and  installat.on  of  rulesets  are  also  discussed. 


The  work  described  here  was  supported  in  part  by  the  Defense  Advanced  Research  Prcjects 
Agency  (DoO),  ARPA  Order  No.  3603,  monitored  by  the  Naval  Electronic  Sysum  Command  under 
Contract  No.  N00039-ai-K-02Sl 
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1.  IntroductioQ 

The  Lyra  layout  rule  checker  can  be  retargeted  to  new  design  rulesets. 
This  is  important  because  design  rules  for  many  different  technologies  and 
processes  are  in  use.  and  because  rules  change  over  time. 

To  retarget  Lyra  for  a  new  ruleset.  it  is  necessary  first  to  prepare  -a 
ruleset  specification  in  the  L)nra  format.  This  rule  specification  can  then  be 
compiled,  by  the  L)rra  rule  compiler,  to  generate  an  executable  file  for 
checking  the  specified  rules.  This  executable  file  is  invoked  by  the  L}n'a  fron* 
tend  to  check  designs  against  the  ruleset. 

This  document  explains  how  to  write  design  rule  specifications  for  Lyra. 
The  next  section  sketches  the  basic  paradigm  for  rules  in  Lyra.  The  following 
three  sections  give  all  the  details  (syntax  and  semantics)  of  rule 
specifications.  The  final  section  gives  suggestions  for  writing,  compiling  and 
testing  Lyra  rulesets. 

2.  The  Idea:  Comer  Based  Rule  Checking 

In  Lyra,  rules  are  given  as  constraints  to  be  applied  at  comers.  Each 
rule  gives  a  context  describing  the  corners  it  applies  to  and  a  set  of  con¬ 
straints  to  be  checked  at  these  corners.  Constraints  are  rectangular  regions 
where  some  combination  of  layers  are  required  or  prohibited.  A  rule  to 
check  spacing  on  a  metal  layer,  M,  would  give  constraints  to  be  applied 
around  the  outside  of  corners  on  layer  M  disallowing  M  in  the  vicinity.  This  is 
illustrated  in  Figure  1.  In  the  figure  the  hatched  constradnt.s  have  been 
violated  indicating  the  two  geo.metries  are  spaced  too  closely.  Ilgure  2  sug¬ 
gests  graphically  the  form  the  spacing  rule  takes  in  Lyra.  The  left  hand  side 
characterizes  convex  corners  on  layer  M,  namely  M  is  present  in  one  qua¬ 
drant  (the  upper  right)  but  not  in  adjacent  comers.  The  right  hand  side  of 
the  rule  gives  a  cluster  of  constraints  to  be  applied  at  all  corners  matching 
the  left  hand  side  of  the  rule.  The  other  corner  orientations,  obtained  by 
rotating  this  rule,  are  implied. 

When  complete  rulesets  are  considered,  several  con^lications  arise.  It 
is  not  sufficient  to  deal  only  with  corners  on  single  mask  layers.  Some  rules 
refer  to  comers  defined  by  the  interaction  of  mask  layers,  for  example 
transistor  rules  in  nMOS  involve  the  comers  generated  by  crossing  polysili¬ 
con  and  diffusion  features.  Some  rules  do  not  apply  at  all  comers  on  a 
layer,  but  only  if  some  additional  layer  pattern  is  present  at  the  comer.  For 
instance  the  Lyon  implant  rules  used  in  the  Berkeley  nMOS  ruleset  require 
one  set  of  constraints  to  be  applied  at  transistor  comers  in  the  direction  of 
polysilicon  and  another  in  the  direction  of  diffusion.  Such  rules  require  the 
specification  of  additional  context  information  in  the  left  hand  side  of  the 
rule.  Finally,  for  completeness,  it  is  necessary  to  consider  concave  comers 
in  addition  to  convex  ones.  However  edl  of  these  situations  can  easily  be  cast 
in  terms  of  the  rule  format  suggested  by  Figure  2.  Surprisingly,  this  simple 
paradigm  can  be  used  to  accurately  express  almost  all  design  rules.  Excep¬ 
tions  are  a  few  rules  involving  connectivity,  and  some  of  the  more  involved 
industrial  rules. 

In  Lyra  rule  specifications,  composite  layers  are  defined  for  rules  which 
do  not  apply  to  comers  on  actual  mask  layers,  and  the  left  band  sides  of 
rules  are  split  into  two  parts:  a  comer  spec^ccdion  giving  the  layer  and  con¬ 
vexity  of  comers  to  which  the  rule  applies,  and  an  also  clause  which  gives 
any  additional  pattern  of  layers  required  for  the  rule  to  apply.  A  set  of  rule 
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macros  is  used  for  concise  coding  of  the  more  common  rules,  e.g.  width  and 
spacing. 

This  is  the  idea  of  the  comer  based  paradigm:  the  following  sections  give 
the  details. 

3.  Deflnitions 

This  section  defines  the  basic  constructs  involved  in  rule  specifications 
for  Lyra.  The  first  part  of  the  section  deals  with  syntax,  and  dimensional 
units.  Then  the  layer  declaration  are  defined.  These  preceed  the  rule 
specifications  in  Lyra  rulefil..3.  The  last  part  of  the  section  develops  the  rule 
construct  which  is  used  directly  to  specify  the  more  complex  or  unusual 
design  rules,  and  to  which  the  macros  given  in  the  next  section  expand.  See 
section  5  for  the  overall  organization  of  rulefiles. 

3.1.  lispS^nutax 

Lisp  syntax  is  used  in  the  Lyra  rule  files.  This  means  constructs  have 
the  general  form. 

{Kconstnict  naTne>  <exprl>  <expr^  ...  <exjrm>) 

The  expressions.  <exprl> . <expm>  may  be  numbers,  layer  names,  text. 

or  subconstructs.  The  use  of  constructs  within  constructs  leads  to  nested 
parenthesized  lists.  For  example,  a  pair  of  rules  concerning  transistor  form 
in  nmosMC.  the  Mead  ic  Conway  nMOS  rules  are  shown  below  (the  details  arc 
not  important). 

:  malformed  green-iransistor  abuUment 
(rule 

(comer:  (a  G)) 

,al8o:  nil  (not  D)  (or  D  (not  P))  (and  P  D  (not  iQ)) 

1  constraints:  (t^d-constraints  (quad3  1 1)  false  "tr  f'})} 

;malformed  red^ransistor  abuUment 
(rule 

S comer  (a  R)) 

also:  nil  (not  D)  (or  P  (not  D))  (and  P  D  (not  X))) 
constraints:  (build-constraints  (quad3  1 1)  false  ”tr  T’))) 

Note  the  use  of  semicolons  to  delimit  comments.  The  lisp  parser  treats  all 
text  between  a  semicolon  and  the  end  of  the  line  as  a  comment. 

The  rule  files  are  actually  executed  as  lisp  code  by  the  rule  compiler. 
Care  must  be  taken  to  balance  parentheses  properly.  If  parentheses  are  not 
balanced,  cryptic  error  messages  from  the  Usp  parser  will  occur  when  com¬ 
pilation  is  attempted. 

Many  editors  provide  special  functions  for  editing  lisp  files.  In  Vi  it  is 
useful  to  set  Usp  and  sfwwmatch  mode: 

:set  liapsm 

yfhen  shanumatch  is  set,  typing  a  closing  parenthesis  causes  the  cursor  to 
momentarily  jumps  to  the  matching  open  parenthesis.  In  Usp  mode,  lisp 
indentation  style  is  supported  (e.g.  with  the  apwn  command),  you  can  move 
from  any  parenthesis  to  its  matching  parenthesis  by  typing  'X,  and  the 
indentation  of  an  expression  can  be  made  to  correspond  to  the  parenthesis 
structure  by  placing  the  cursor  at  the  beginning  of  the  expression  and  typing 
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3.2.  Units 

Distances  are  specified  in  the  same  units  used  in  the  input  Caesar  files, 
and  should  be  integral.  Caesar’s  internal  units  are  half  as  big  as  the  units 
apparent  to  the  user.  Thus  normally  one  unit  corresponds  to  1/2  lambda. 

Since  Lyra  is  not  raster  based,  distances  can  be  scaled  up.  say  for 
greater  precision,  without  significantly  affecting  performance.  Note  however 
that  numbers  with  absolute  value  less  than  1024  are  stored  more  elTiciently 
in  Franz  Lisp,  and  thus  in  Lyra,  than  larger  numbers. 

3.3.  Layan  and  lYedieales 

A  rufe  in  Lyra  consists  of  a  left  hand  side  (LHS)  specifying  the  context  in 
which  the  rule  applys  and  a  right  hand  side  (RHS)  specif}ring  constraints 
which  apply  wherever  the  LHS  holds.  Both  the  LHS  and  RHS  of  rules  involve 
layers  and  combinations  of  layers.  Layers  come  in  three  varieties:  primary 
layers,  grown  layers,  and  composite  layers.  Predicates  are  used  to  specify 
layer  combinations. 

3.3.1.  Primary  Layers 

Primary  layers  are  just  the  mask  layers  of  the  technology  to  be 
checked.  Primary  layers  are  specified  as  follows: 

(primary-layers 

(<intemai name>  ^<Caesarname>  <ci/name>)) 

) 

It  is  convenient  to  choose  short  internal  names  (one  or  two  characters),  and 
to  capitalize  the  first  character.  The  cif  name  is  provided  so  that  Lyra  can 
accept  cif  names  in  place  of  Caesar  names  in  the  input  file.  This  simplifys 
the  interface  between  Lyra  and  programs  not  using  the  Caesar  data  format, 
such  as  KIC.  The  primary  layer  specification  for  nmosMC  looks  like  this: 

(primary-layers 
(P  (pdysUicon  NP)) 

(D  (dilluaioo  ND)) 

(M  (metal  NH)) 

(I  (implant  Nlj) 

(C(cutNC))) 

3.3.2.  Grown  Layers 

A  grown  layer  is  generated  from  a  primary  layer  by  expanding  each  rec¬ 
tangle  on  the  specified  primary  layer  by  a  specified  amount.  Here  is  the  form 
of  the  grown  layers  specification: 

(grown^ayers 

{<grown  layer  name>  <primary  layer>  <amount>J 

) 

KOi-awn  layer  name>  gives  a  name  for  the  new  layer.  <Prvmary  layer>  is  the 
internal  name  of  a  primary  layer.  Each  edge  of  each  rectangle  on  <primary 
Uryer>  is  shifter  out  by  <amount>  units  to  create  the  corresponding 
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rectangle  on  layer  <grown  layer  name>. 

Growl  layers  are  created  prior  to  all  other  processing  in  Lyra,  and  once 
created  they  are  treated  exactly  as  primary  layers  are.  Note  that  grown 
layers  are  internal  to  Lyra  only,  they  are  never  output. 

Grown  layers  should  be  used  cautiously  since  they  increase  the  memory 
requirements  for  processing  designs  substantially.  Also,  the  largest  amount 
grovm,  is  added  to  the  largest  constraint  size  in  a  ruleset  to  determine  the 
dssiyn  rule  interaction  (Stance.  If  the  design  rule  interaction  distance  is 
large,  hierarchical  processing  will  suffer. 

Currently  only  the  nmosMC  rules  make  use  of  a  grown  layer.  In  the 
nmosMC  rules  the  contact  cut  layer  is  grown  out  by  one  lambdau  to  provide 
sufficient  context  to  distinguish  certain  corners  in  butting  contacts  from 
similar  corners  in  badly  formed  transistors.  The  specification  of  this  grown 
layer  in  the  nmosMC  rules  is: 


(grown-layera 
^C2)):X  = 


(X  C  2)) :  X  =  cut  grown  by  1  lambda  =  eut-contaxt  layer 

Remember  that  two  units  correspond  to  one  lambda. 

3.3.3.  Predicaiea 

Predicates  define  combinations  of  layers.  They  are  used  in  specifying 
Composite  Layers,  in  specifying  the  context  patterns  in  the  LKS  of  rules,  and 
in  defining  constraints  in  the  I^IS  of  rules. 

Predicates  have  the  following  forms: 

<Primary  or  Ovwn  Layer>, 

inoi  <Pre<hcate>), 

and  <Predicate>  <Predicate>  and 
or  <Predicate>  <Ptedicate>  ...). 

Arbitrarily  complex  layer  combinations  can  be  defined  in  this  way.  Some 
examples  of  predicates  are, 

M  :n«aenca  of  layer  H 

(not  M)  U^beenee  of  H 

(and  P  D  (not  CO)  :P  and  D  both  present,  but  not  C. 

3^3.4.  Composite  Layers 

In  Lyra  each  rule  applies  to  comers  on  a  specific  layer.  Many  rules 
apply  to  corners  on  primaiy  layers,  but  some  rules  refer  to  corners  resulting 
from  the  interaction  of  layers.  These  rules  occur  at  corners  on  a  composite 
layer  defined  as  a  combination  of  primary  (and  grown)  layers.  These  compo* 
site  layers  must  be  defined  at  the  front  of  the  rules  file  by  a  specification  of 
the  following  form: 

(compoaitaHayars 

(<coin}XMtie  layernams>  <dejlning predicate>) 


For  example  the  composite  layers  specification  for  the  nmosMC  rules  looks 
like  this: 
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(compoaite>layen 
f  R  f  and  P  (or  X  (not  D)))) 

(G  (and  D  (not  ^)) 
rr  (and  P  D  (not  iQ)) 

(and  P  D  (not  1}  (not  X))) 


:  red 
green 
tranaiator 

:  enhancement  mode  tranaiator 


,EI 

Z  (and  P  D I  (not  10))  '•  depleticm  mode  translator 

PC  (and  P  C))  :  poly«ut 

GC  (and  D  C  (not  P)))  :  dif-cut 

(and  X  {or  (not  11)  (not  (or  P  D))))))  ;  bad  cover  over  contact 


Note  tha :  unlike  grown  layers,  composite  layers  are  not  actually  constructed 
in  the  diita  base,  they  simply  refer  to  combinations  of  primary  and  grown 
layers. 

3.3  5.  Layers 

Oncu  specified,  primary-layers,  grown-layers  and  composite-layers  are 
all  used  in  identical  fashion.  When  the  term  layer  is  used  below  it  is  meant  to 
encompass  all  three  types  of  layers. 

a4.  LHS 

The  LHS  of  a  rule  defines  the  context  in  which  the  rule  applies.  It  gives 
the  rele>»ant  comer  layer  (the  layer  on  which  corners  are  to  be  examined)  a 
comer  (convex  or  concave)  and  any  additional  pattern  of  layers  that 
must  occur  at  a  comer  for  the  rule  to  apply.  This  section  gives  the  details 
involved  in  specifying  the  LHS's  of  rules. 

3.4.1.  Corners 

Eacli  rule  refers  to  comers  on  a  specific  layer  (primary,  grown  or  com¬ 
posite)  and  of  a  specific  type  (either  convex  or  concave).  Convex  comers, 
such  as  those  on  a  square  are  designated  by  the  letter  ’a.'  (read  acute  — 
though  technically  a  misnomer).  Concave  comers,  such  as  those  inside  a  U- 
shape,  ai'e  designated  'o"  (read  obtuse).  Comer  specifications  in  rules  have 
the  form. 

(comer:  <type>  <layer>) 

Where  <type>  is  'a'  for  convex  corners,  and  'o'  for  concave  comers  as 
explained  above.  Examples: 

(comer:  a  H)  ;  rale  la  to  apply  to  convex  comers  on  layer  II. 

(comer  o3Q  ;  rule  is  to  a^ly  to  concave  comers  on  layer  X 


3u4.2.  Canonical  Orientation  and  Quadrant  Numbers  In  addition  to  the 
comer  layer  and  type  explained  above,  it  is  sometimes  desirable  to  specify 
an  additional  pattern  of  layers  which  must  occur  at  a  comer.  To  express  this 
additional  pattern  information,  and  also  to  express  the  location  of  the  con¬ 
straints  in  the  RHS  of  the  rule,  horizontal  and  vertical  lines  are  drawn 
through  the  comer  under  consideration,  dividing  space  into  four  qiiadrants. 
Following  standard  convention,  the  quadrants  are  numbered,  by  designating 
the  upper  right  quadrant  the  first  quadrant  and  counting  counter  clockwise 
from  there  (see  Figure  4). 

Since  a  comer  can  be  oriented  in  four  ways  with  respect  to  these  qua¬ 
drants,  it  is  necessary  to  choose  a  fixed  canonical  orienfotion,  so  that  there 
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is  a  definite  relationship  between  corners  and  the  information  specified  in 
terms  of  the  quadrant  system.  In  Lyra  rule  specifications,  comers  are 
always  assumed  to  he  centered  on  the  first  quadrant,  as  illustrated  in  Figure 
5.  The  canonical  orientation  is  used  only  to  facilitate  the  specification  of 
rules:  the  rules  apply  equally  to  corners  of  all  four  orientations. 

3.4.3.  Also 

The  also  clause  can  be  used  to  specify  combinations  of  layers  which 
must  be  present  (or  absent)  in  each  of  the  four  quadrants  immediately  adja¬ 
cent  to  a  corner.  A  rule  applys  to  a  coiner  only  if  all  also  conditions  are 
satisfied.  The  tiisa  claoase  hu  the  form, 

(also:  <predicate  for  quadrant  J> 

Kpredicate  far  quadrant  2> 

<predicatt  for  quadrant  3> 

<pr!’dicate  for  quadrant  4>) 

Predicates  are  defined  in  a  previous  section.  If  there  are  no  additional  con¬ 
text  requirements  on  a  quadrant,  *nil’  ca:i  be  used  in  place  of  a  predicate.  If 

the  conditions  on  Ihe  second  and  fourth  quadrant  are  distinct,  a  mirrored 
version  of  the  rule  is  automatically  generated  by  the  rule  compiler,  so  that 
all  eight  symmetries  (orientations)  of  the  rule  will  be  checked.  The  also 
clause  is  optional:  in  many  cues  a  rule  applies  to  all  corners  of  the  layer  and 
type  specified  in  the  corner  clause,  and  ar  also  clause  is  not  needed. 

The  corner  and  also  clauses  together  constitute  the  LKS's  of  rules. 


convex 


COMCAVE 


ngure  S.  Canonical  Corner  Orientation. 
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3.5.  RHS 

The  RHS  of  a  rule  gives  one  or  more  constriunts  which  are  checked  at  all 
comers  which  match  the  LHS  of  the  rule.  Constraints  are  defined  in  terms  of 
a  rectangular  region  and  a  predicate.  One  corner  of  the  constraint  rectangle 
always  coincides  with  the  corner  in  the  design  that  the  rule  is  being  applied 
to.  This  corner  is  called  the  generating  corner  for  the  constraint.  If  the 
predicate  does  not  hold  throughout  the  interior  of  the  constreunt  rectangle, 
the  constraint  is  violated,  and  a  design  rule  violation  is  reported.  Each  con¬ 
straint  also  has  an  associated  text  string  which  is  output  with  violation 
reports  to  identify  the  nature  of  the  violatioa 

Constraint  rectangles  can  be  specified  directly  by  giving  the  quadrants 
in  which  they  are  located  and  their  dimensions.  Several  macros  are  also  pro¬ 
vided  for  the  most  common  constraint  configurations.  The  details  of  specify¬ 
ing  constraints  are  given  below. 

3w5.1.  ^olaUoaText 

By  convention  Lyra's  violation  messages  have  the  form: 

*'<  Laytrs  or  Constructs  >_<  Type  >" 

<Layers  or  CbnstTucts>  gives  the  single  character  abbreviations  for  the 
layers  involved  in  the  violation.  Circuit  constructs  such  as  transistors  and 
buried  contacts  may  aiso  be  indicated  by  short  abbreviations  (e.g.  tr  for 
transistor;  Be  f'**'  buried  contact).  <Type>’s  are  one  or  two  characters  indi¬ 
cating  the  type  of  error  as  follows; 

■  s  minimum  spacing  violation, 
w  =  minimum  width  violation, 
pe  =  parallel  edge  spacing  violation, 

X  =  insufficient  extension  or  enclosure, 
p  =  polarity,  e.g.  diffusion  doping  doesn't  match  well  in  CMOS, 
f  =  malformed  circuit  construct 

For  example,  the  text  string  for  a  spacing  violation  between  polysilicon  and 
diffusion  would  look  like  this: 

T/D_p". 

New  types  can  of  course  be  invented  if  none  of  the  ones  listed  fits.  We  have 
found  it  best  to  keep  violation  messages  short  since  long  messages  tend  to 
overlap  each  other  in  the  graphical  output  and  become  illegible. 

The  quotation  marks  delimiting  the  text  string  are  for  the  benefit  of  the 
lisp  parser,  they  do  not  appear  in  violation  reports.  Violations  are  actually 
reported  as  Caesar  labels  with  the  label  texts  corresponding  to  the  violation 
messages,  and  the  label  boxes  corresponding  to  the  violated  constraint 
regions.  An  explanation  mark.  '!'.  is  automatically  prepended  to  the  begin¬ 
ning  of  the  all  violation  messages  so  that  violations  can  be  easily  located  with 
the  Caesar  search  command. 
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3.5.2.  Direct  ^wcificatiMi  of  Constraints 

If  the  RHS  of  a  rule  contains  only  one  constraint,  it  can  be  specified 
using  the  buUd-constravnts  construct  as  follows: 

(constraints: 

(build-constraints 

(quad<i>  <z  dajmnsion>  <y  ^mensiony) 

<pred'icate> 

<taxt>)) 

Here  <i>  gives  the  quadrant  number  of  the  constraint:  1.2,3  or  4.  <X  dvrien- 
sion>  and  <y  dime‘nsiaTi>  give  the  dimensions  of  the  constraint.  </Vediciife> 
is  the  predicate  required  to  hold  inside  the  constraint  region.  An  always- 
violated  constraint  can  be  coded  by  using  'false*  for  <predictxte>.  This  is 
used  in  rules  where  the  LHS  gives  a  corner  pattern  which  should  not  occur. 
<text>  is  a  quoted  text  string  describing  the  design  rule  viclation,  as 
explained  above.  Append  is  used  to  specify  multiple  constraints  for  a  rule: 

(constraints: 

(append 

(l^ld-constraints  .) 

(build-constraints  .  .) 

)) 

Where  each  build-constraints  construct  is  structured  as  above.  The  following 
example  is  from  the  C.MOS  rules,  cmos-pwJPL. 

(constraints: 

(append 

(biiild-constraints  (quadl  6  1)  C  "sc  f") 

(build-constraints  (quad2  6  1)  C  "sc  T’))} 


3.5.3.  Constraint  ^wciflcation  ustog  Macros 

Some  frequently  occurring  constraint  configurations  can  be  specified 
using  macros.  Ihese  specifications  take  the  general  form, 

(constraints: 

(<consfraint  macro>  <dimension>  <predicat»>  <text>)) 

Where  <consfT-atnf  macro>  is  one  of:  insidM.  outside,  e-inside,  e-autside,  s- 
inside,  and  s-^utside.  All  constraint  dimensions  are  either  <dimension>  or 
one  unit.  <Predxcate>  and  <text>  specify  a  common  predicate  and  text  for 
the  generated  constraints.  Figure  6  shows  the  constraint  configurations 
corresponding  to  the  six  macros.  Remember  that  the  canonical  corner 
orientation  is  aissumed  when  specifying  constraints. 


3w6.  Rules 


We  have  now  defined  ail  the  pieces  necessary  to  specify  rules  in  Lyra.  As 
we  have  seen,  the  LKS’s  of  rules  consist  of  corner  and  also  constructs  which 
define  the  context  in  which  the  rules  apply.  The  RHS's  of  rules  consist  of 
constraint  constructs  which  define  constraints  on  corners  where  the  rules 
apply.  The  general  form  of  the  rule  construct  is: 
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nfure  6.  Constraint  Macros. 
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(constraints:  ...)) 

Where  the  also  construct  is  optional  as  suggested  by  the  brackets.  For 
example,  three  rules  from  the  nmosMC  rules  cwicerning  the  form  of 
poly/metal  contacts  look  like  this: 

:c.  Poly-Cut  extensioa  (complicated  to  handle  butting  contacts) 

(rule 

(comer:  (o  P)) 

(constraints:  (e-inside  2  (not  PC)  "P/C  ±'))  ) 

(rule 

(comer  (a  PC)) 

(also:  nil  (not  GC)  nil  (not  GC)) 

(constraints:  (e-outside  2  P  "P/C  x"))  ) 

(rule 

(comer  (a  PC)) 

(also:  nil  nil  nil  GC) 

(constraints:  (build-constraints  (quad2  2  1)  P  "P/C  z"))) 

4.  Rule  Macros 

This  section  gives  the  rule  macros  provided  with  the  Lyra  system.  These 
macros  allow  the  easy  and  concise  coding  of  many  common  rules.  The 
expansion  of  each  macro  is  given  both  in  terms  of  the  rule  construct  of  the 
last  section  and  graphically.  In  addition  to  defining  the  macros  precisely, 
these  expansions  are  good  examples  of  the  use  of  the  rule  construct  and  the 
corner  based  paradigm. 

Each  macro  takes  one  or  two  layers  as  arguments.  These  layers  can  be 
of  any  type:  primary,  grown  or  composite. 

4.1.  width 

The  width  macro  has  the  form: 

(width  <layer>  «iimansian>  <text>') 

This  macro  checks  that  <layer>  is  at  least  <dijnension>  wide  everywhere. 
The  macro  expands  into  two  rules,  one  for  concave  comers  on  <loyer>  and 
one  for  convex  comers  on  <layer>.  The  second  rule  is  necessary  to  check 
that  a  pair  of  closely  placed  holes  in  <layer>  do  not  result  in  a  narrow  strip. 
(‘wrUttK  P  4  expands  to: 

(rule 

! comer  (a  P)) 

constraints:  (inside  4  P  "PJT'))) 

(rule 

!  comer  (o  P)) 

constraints:  (e-inside  4  P  "P_JO)) 

These  rules  are  shown  graphically  in  Figure  7. 


4J 


Single  layer  spacing  can  be  specified  with  the  ss  macro.  This  macro  has 
the  form: 

(as  <layer>  <dimension>  <t9xt>) 

This  macro  checks  for  a  spacing  of  <dimension>  between  mask  features  on 
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Rgure  7.  Width  Rules,  (width) 

<layer>.  Like  the  width  macro,  ss  expands  to  two  rules:  one  for  convex 
comers  and  one  for  concave.  The  second  rule  checks  for  small  holes  in 
<layer>. 

(as  P  4  "Pj")  expands  to: 

(rule 

(comer:  (a  P)) 

(coastraints:  (e-outside  4  (not  P) 

(rule 

(comer,  (o  P)) 

(constraints:  (outside  4  (not  P)  "Pj*"})) 

This  is  shown  graphically  in  Figure  8. 

4.3.  pe 

Parallel  edge  checks  can  be  done  with  the  pe  macro. 

(pe  <laysr>  <dimmaion>  <fezf>) 

This  macro  checks  spacing  between  adjacent  feature  edges  on  a  layer.  The 
difference  between  parallel  edge  checks  and  spacing  or  width  checks  is  that 
the  parallel  edge  checks  are  not  concerned  with  di^onal  spacing.  These 
checks  are  used  to  guard  against  thin  slivers  of  resist  dxiring  fabrication. 
Such  thin  slivers  could  break  off  and  be  deposited  somewhere  else  on  the 
design  causing  damage. 
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Figure  9.  Parallel  Edge  Rules,  (pe) 


4.3.1.  sep 

The  sep  :-nacro  can  be  used  to  check  interlayer  spacing. 

(sep  <lay3r  1>  <layar  Z>  <dmimsian>  <fezt>) 

This  checks  that  <layvr  1>  and  Klaytr  2>  are  spaced  at  least  <tiimension> 
apart,  and  where  this  is  not  so  reports  violations  with  message  <fezf>.  Sep 
assumes  <fayer  1>  and  <fayer  2>  do  not  overlap.  In  some  cases  the  two 
layers  are  logically  disjoint  and  this  condition  need  not  be  checked.  This  is 
true,  for  example,  if  <layer  1>  is  nonimplanted  gate  regions,  and  <layer  2>  is 
implant  If  the  two  layers  are  not  logically  disjoint,  the  sep  test  must  be  aug¬ 
mented  with  a  disjointness  test.  An  easy  way  to  check  that  for  this  is  to 
define  a  composite  layer  to  be  the  overlap  of  <layer  i>  and  <lai^  Z>.  e.g. 
(and  Klaysr  1>  <layer  2>).  and  then  write  a  rule  that  generates  violations  at 
all  convex  comers  of  the  composite  layer. 

The  expansion  of  (aep  A  B  4  is; 

(rule 

(comer  (a  A)) 

(eonatrainta:  (outaide  4  (not  B)  "AB_p”))) 

(rule 

(comer  (a  B)) 

(eonatrainta:  (a-outaide  4  (not  ^  "AB_p"))) 

This  is  shown  graphically  in  Figure  10.  Note  that  the  constraints  on  layer  A 
and  layer  B  are  not  symmetricaL 
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Figure  10.  Interlayer  Spacing  Rules,  (sep) 


4.3.2.  ext 

Enclosure  rules  can  be  written  using  the  8Xt  macro. 

(ext  <layeT  »>  <.layer  2>  <dxrmnsum>  <fezf>) 

This  specifies  that  <lttyer  1>  must  extend  beyond  Klayer  Z>  by  <(iuncnston> 
in  all  directions.  The  ext  macro  assumes  <layer  J>  covers  <Uxyer  2>  every¬ 
where.  If  this  is  not  logically  required  by  the  definitions  of  ^ayer  1>  and 
Klayer  2>,  then  it  must  be  checked  for  separately.  This  can  be  done  by  look¬ 
ing  for  the  existence  of  a  composite  layer  (and  <fayer  1>  (not  <layer  2>)). 
The  expansion  of  (ext  A  B  4  "ABj^’)  looks  like  this: 

(rule 

(conier:  (a  B)) 

(eonatraints:  (outside  4  A  ”AB_]r"))) 

(rule 

(eomOT:  (o  A)) 

(constraints:  (s-inside  4  (not  B)  ''AB_x”))) 

This  is  shown  graphically  in  Figure  11. 

5.  Role  FUe  Organization  and  Naming 

The  overall  organization  of  Lyra  rule  files  is  as  follows: 


1.  Primary  layer  specification 

2.  Grown  layer  specification 
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ng[ure  11.  Enclosure  Rules,  (ext) 

3.  Composite  layer  specification 

4.  Rule  constructs  and  rule  macros 

All  but  the  primary  layer  specification  is  optional. 

By  convention  ruiesets  are  named  by  appending  an  indication  of  the 
source  (in  capital  letters)  to  the  name  of  the  technology  (as  known  to  Cae* 
sar).  The  symbolic  rule  flies  are  given  extension  ’.r’.  Thus:  nmosMC.r, 
nmosBERK.r,  and  cmos-pwJPLr  are  the  source  files  for  the  Mead  &  Conway 
nMOS  rules,  the  Berkeley  nMOS  rules,  and  the  JPL  CMOS  rules  respectively. 
These  ruiesets  can  be  found  in  '^cad/lib/lyra. 

8.  Writing,  Compiling,  and  Testing  Rule  Files 

The  Lyra  rule  compiler,  Rulac,  is  used  to  generate  an  executable  Lyra 
from  a  ruleset  file.  Rulec  is  a  shell  script  which  invokes  three  processing 
steps: 

(1)  Compile  rule  file  to  lisp  code  (Ruled) 

(2)  Compile  lisp  code  to  object  code  (liszt) 

(3)  Link  rule  specific  object  code  with  a  Lisp  containing  rest  of  the  L}rra 
code  to  generate  an  executable  Lyra. 

Together,  the  three  steps  take  about  10  cpu  minutes  for  a  typical  ruleset. 
Syntax  errors  in  the  input  file  will  be  caught  by  the  lisp  parser  during  step  1, 
and  will  result  in  strange  error  messages.  Many  text  editors  have  special 
features  to  help  balance  parentheses  properly  in  lisp  code.  The  section  on 
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Lisp  Syntax  above  describes  such  features  in  Vi.  The  executable  Lyra  pro¬ 
duced  in  the  third  step  will  have  the  same  name  as  the  input  file,  but  without 
the  ’.r’  extension. 

The  best  way  to  go  about  writing  a  new  ruleset  is  to  copy  and  then 
modify  an  existing  ruleset.  The  nmosMC,  nmosBERK  and  cmos-pwJPL 
rulesets  can  be  found  in  ~cad/lib/lyra.  It  would  be  helpful  to  read  through 
these  rulesets  carefully  to  see  how  some  of  the  more  complicated  rules  are 
handled.  You  can  work  in  “^cad/Ub/Iyra  or  in  your  own  area.  Note  however 
that  each  executable  Lyra  produced  by  Rulec  is  about  one  megabyte  big! 

After  a  ruleset  is  compiled  .  it  can  be  tested  in  batch  mode  by  giving 
Lyra  the  -r  option  with  the  full  pathname  of  the  executable  for  your  ruleset. 

lyn  -r  ~me/inynilea  tiMtfile.ca 

Your  ruleset  can  also  be  invoked  interactively  from  Caesar  by  giving  the  full 
pathname  of  your  file  as  an  argument  to  the  Caesar  lyra  subcommand. 

ilyra  '^me/myrules 

It  is  a  good  idea  to  exercise  each  new  rule  both  with  cases  that  should  pass 
the  rule  and  cases  that  should  Moiate  it.  It  is  useful  to  keep  around  the  test 
flies  you  create  for  your  rules.  They  can  be  rerun  at  any  time  to  see  if  any¬ 
thing  has  been  broken.  One  way  to  quickly  generate  test  cases  is  to  make 
multiple  copies  of  some  structure  and  then  modify  each  copy  in  a  different 
way. 

A  ruleset  cam  be  made  the  default  for  a  given  Caesar  technology  by 
adding  an  entry  to  *»cad/lib/lyra/’D£r AULTS.  You  can  also  create  a  personal 
default  by  setting  the  Lyra  V  option  in  the  .cadre  file  in  your  home  direc¬ 
tory. 

More  details  on  Ridec.  Lyra,  and  Chesar  are  given  in  the  (c  ad)man  pages 
for  these  programs  and  in  the  Caesar  manual. 
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